v13update10.txt

AVE1000S系列卡SDK&Driver

SAPI    UINT DLLCALL  sapiGetCompressData(UINT CardID,UINT EncoderID,BYTE * buffer,int length,int * State);
   在同一程序下只能使用一种接口，注意消息接口优于回调接口。一旦注册了窗口则回调接口无效。
3. 新增
    SAPI    int sapiFindCompressHead(int type,BYTE * inbuf,UINT length,BYTE * outbuf,UINT * outbufLen,BOOL IsFirst);
    该函数可从Mpeg-1视频流，或系统流中找到结构边界，以便将流切为不同的分段，存为不同文件。
    它比sapiSearchB4TYPE使用更方便，简单。
4.
SAPI    BOOL DLLCALL  sapiGetMpegFileTime(char * filename,MPEGTIME * pStartTime,MPEGTIME * pEndTime);
   该函数可从记录的MPEG文件中获取时间信息，获取起止时间。
   
5. Dephi 接口文件同步更新SSAPI.PAS  

6. tt3v6.exe 演示及测试程序同步更新，演示了上述函数的使用，说明见simpapi13.txt。
 

                  SSAPI V12  说明:

该版改动较大:
新函数说明见SIMPAPI12.TXT
1. 最大支持40路S系列卡工作
2. 新增对AVE3000(S3000) Mpeg-1 A/V 同步压缩卡的支持.
3. 新增压缩流报警处理函数,及报警内核更新,使压缩流报警更方便,准确(原报警接口仍可用,但内核是旧的)
    SAPI    BOOL DLLCALL sapiEnableCallBackDetect(UINT CardID,UINT EncoderID);
    SAPI    BOOL DLLCALL sapiDisableCallBackDetect(UINT CardID,UINT EncoderID);
    SAPI    BOOL DLLCALL sapiMpgMoveDetect(UINT CardID,UINT EncoderID,int DataType, BYTE * buffer,UINT length);
    SAPI    BOOL DLLCALL sapiMpgSetMoveDetectLevel(UINT CardID,UINT EncoderID,UINT level);
    SAPI    BOOL DLLCALL sapiMpgSetMoveDetectInterval(UINT CardID,UINT EncoderID,UINT interval);
    SAPI    BOOL DLLCALL sapiMpgSetMoveDetectArea(UINT CardID,UINT EncoderID,DetectAera * pDetectAera);
    SAPI    BOOL DLLCALL sapiMpgMoveDetectReset(UINT CardID,UINT EncoderID);
4. 新增预览流捕获函数,使捕获更方便,快速.
    SAPI    BOOL DLLCALL sapiPrepareMemBmpCap(UINT CardID,int ChannelID,UINT Width,UINT Height,BOOL IsSingle,stBMP2 * pstBmp);
    SAPI    BOOL DLLCALL sapiPrepareDispBmpCap(int MRgnID,int SRgnID,stBMP2 * pstBmp);
    SAPI    BOOL DLLCALL sapiBmpCap(stBMP2 * pstBmp);
    SAPI    BOOL DLLCALL sapiSingleMemBmpCap(stBMP2 * pstBmp);
    SAPI    BOOL DLLCALL sapiReleaseBmpCap(stBMP2 * pstBmp);
    SAPI    BOOL DLLCALL sapiSaveBMPTOFile(char * finame,stBMP2 * pstBmp);
    SAPI    BOOL DLLCALL sapiSaveBMPTOFile(char * filename,stBMP2 * pstBmp);
5. 对SSAPI内部有一些修改,以改进性能和可靠性.
6. 对SSAPI文档修改.
7. 新增Dephi的SSAPI接口SSAPI.PAS及Dephi的简单Demo程序(有源码),建议用户采用Dephi快速开发应用程序.
8. 测试程序TT3V6.exe有一些修改,加入了新报警处理Demo.及新预览流捕获.
9. SSAPI V12向下兼容V11Update5 ssapi.　
	
*****************************************************************************
以前V11各版说明：

                   V11Update5 pitch2: 说明：
1.修正了音频记录，监听同时进行时，关闭监听，切换到其它路时，本路记录会停止问题。
源码修改：SSAPI的SSAPI_AUDIO.CPP CloseAudioStream中
       if(pHWObj->m_AudioState.Playing&&pHWObj->m_AudioState.Recording)
应改为 if(pHWObj->m_AudioState.Playing||pHWObj->m_AudioState.Recording) 
2.修正了因修正1产生的音频关闭时的死机现象。

仅更新了SSAPI的ssapi_audio.cpp 用户可自己更换。运行库在SSAPI/Release下。
        
                   S1000 V11 Update5 说明：
本更新是对S1000 V11(包括Update1,或Update2,Update3Full,Update4Full)版的更新.

1.增加了对AVE2000X卡开发包API接口的支持，熟习X卡SDK的用户可快速使X卡应用程序能够
  运行S卡，以及混合运行X，S卡。详见SFORXAPI目录下S1000FORXAPI.TXT说明。

2.增加了4个SAPI函数，详见SIMPAPI.TXT
  获得硬件对象指针，直接操纵硬件对象，实现基本SDK与SSAPI混合编程，以便高效，灵活地实现应用程序。 
  SAPI BOOL DLLCALL sapiGetHWObjPtr(int CardID,int HWObjID,void ** ObjPtr );
  获得TVCARD.INI文件[ENCODER]节编码器参数。
  SAPI BOOL DLLCALL sapiGetIniFileEncoderParams(UINT CardID,unsigned int enc_id,ENCODERPARM * pEncoderParams);
  判断视频输入信号是否中断，可用于检测视频输入信号的有无。
  SAPI int DLLCALL sapiIsVideoSignalExist(UINT CardID,UINT VChannelID,int VInputChannel);
  支持SQ PRO卡的变帧速率MPEG压缩功能
  SAPI BOOL DLLCALL sapiSetCompressFrameRate(UINT CardID,UINT EncoderID,unsigned int nOnFrame,unsigned int nOffFrame);


3.修正了SSAPI文档SIMPAPI.TXT的部分错误。
4.修正了sapiSetCardUsrData定义错误（SSAPI.H）
5.修正了S卡（特别是对PRO卡）音频功能的部分错误，对所有S卡系列在44.1K,22.05K,11.025K，单声道，双声道
16bits,8bits采样均可正常工作。在11.025K/单声道/8bits方式工作时位速率仅为88kbits/S低于MPEG1
的192,224kbis/s （SSAPI.dll;SurvAPI.dll）.
6.修正了显示库的部分错误（Display.dll）在WIN2000下按CTRL-ALT-DEL不再产生问题，主显示通道
边界错位产生显示变色问题也已解决。

7.改变了函数sapiExDetect2的参数，并给了一个例子；说明如何使用该函数。使用该函数比用sapiStartDetect2WithCompressRec线程方便，更灵活。
例子程序DetectTt3v6的void CMainFrame::OnStartCAUF() 函数说明了只要打开压缩流，在压缩流的回调函数中进行检测，并写入文件即可。
示例是在动目标报警时记录，并记录了用户输入时间；当在该时间内又有报警，则从这一刻起，又记录用户输入的间隔时间。

更新方法：将Detect2dll.dll,Detect2dll.lib覆盖，并增加所有sapiExDetect2函数参数，Detect2.cpp的sapiExDetect2函数用新的覆盖即可。
 

                   S1000 V11 Update4 说明：
1.增加了对SSAV1 MPEG1音，视频同步实时压缩卡的支持，该卡目前可完成
VCD格式的MPEG1复合音视频流的压缩，速率暂不可变。使用同样的SSAPI，
用户程序不变。

2.增加了5个显示SAPI函数，用于实现满屏显示及快速缩放某个子区域，详见SIMPAPI.TXT
BOOL sapiOverlayFullScreenPreview(int MRgnID,int SRgnID);
BOOL sapiOverlayZoomScreenPreview(int MRgnID,int SRgnID,RECT * pZoomRange);
BOOL sapiUnOverlayFullScreenPreview(int MRgnID,int SRgnID);
BOOL sapiUnOverlayZoomScreenPreview(int MRgnID,int SRgnID);
BOOL sapiUpdateFullOverlay();
演示程序tt3v6.exe 相应增加了缩放演示菜单项OverlayZoomFull,OverlayZoom。
3.增加SAPI函数sapiDisplayCreate返回1,表示显卡不支持覆盖方式(OVERLAY).详见SIMPAPI.TXT

2.修正了显示库Display.dll越界时（显示区超出屏幕）产生的错误。
3.修正了在WIN2000下，用声卡实时监听声音时，有时会死机的错误。
4.修正了SAPI压缩函数少量小漏洞。
4.修正文档SIMPAPI.txt中的错误:
VideoStandard：压缩视频标准1为PAL，0为NTSC。我国为PAL(1).
原错误为“0 PAL, 1 NTSC.
5.对基本SDK文档Manual.txt增加部分说明。
6.更新了硬件库SurvAPI.dll,显示库Display.dll,API ssapi.dll,演示程序TT3V6.EXE
7.增加了压缩流报警及其记录（含有Detect2的函数及文件,ssapi与预览流报警(Detect.cpp)无关）。ssapi及演示程序DetectTt3v6.exe都有更新（增加压缩流报警记录功能），
  具体更新如下：
  ssapi:
  --增加Detect2目录，包含：Detect2dll.dll,Detect2Dll.lib,MotionDetect2.h,Detect2Info.h,DetectInfo.h及
         DetectInfossapi.h,Detect2Infossapi.h,MotionDetect2ssapi.h
  -- ssapi.h,HWobj.h,hwobj.cpp,Disp.cpp有少量改动,增加Detect2.cpp。具体操作：覆盖ssapi.h,hwobj.h,hwobj.cpp,Disp.cpp，Detect2.cpp。
DetectTt3v6:
  增加了菜单：AlertForCompressStream用于压缩流报警记录示例。
  MainFrm.cpp有改动（增加与压缩流报警记录相关的函数及使用）。
8.增加了12个压缩流报警函数：
  	SAPI BOOL DLLCALL sapiGetCardIDFromRegionID(int MRgnID,int SRgnID,int &CardID,int &ChannelID);
	SAPI BOOL DLLCALL sapiGetRegionIDFromCardID(int CardID,int ChannelID,int &MRgnID,int &SRgnID);
	SAPI BOOL DLLCALL sapiInitMotionDetect2(int CardID,int ChannelID);
	SAPI BOOL DLLCALL sapiDeleteMotionDetect2(int CardID,int ChannelID);
	SAPI BOOL DLLCALL sapiRegisterDetect2Fun(int CardID,int ChannelID,DETECT2CALLBACK Detect2CallBack,void * pParams);
	SAPI BOOL DLLCALL sapiUnRegisterDetect2Fun(int CardID,int ChannelID);
	SAPI BOOL DLLCALL sapiSetParams(int CardID,int ChannelID,USRDETECTINFO userInfo);
	SAPI BOOL DLLCALL sapiStartDetect2WithCompressRec(BOOL bAlert,BOOL bWrite,UINT CardID,UINT EncoderID,stEncoderParams * pParams);
	SAPI BOOL DLLCALL sapiStopDetect2WithCompressRec(UINT CardID,UINT EncoderID);
	SAPI BOOL DLLCALL sapiIfDetect2Going(int CardID,int ChannelID);
	SAPI BOOL DLLCALL sapiGetDetect2UsrInfo(int CardID,int ChannelID,USRDETECTINFO * usrInfo);
	SAPI BOOL DLLCALL sapiExDetect2(int CardID,int ChannelID,unsigned char *pCompressBuffer);
9.  对压缩流报警及记录的函数基本说明见SIMPAPI.TXT。
10. 预览流报警，压缩流报警相应应用程序使用及函数说明分别参看DetectReadme.txt,Detect2Readme.txt。
    预览流报警函数及文档均与Detect相关；压缩流报警函数及文档均与Detect2相关。
11. 从该版本开始，报警示例应用程序及更新见DetectTt3v6.exe。
    原TT3V6.exe则作为基本的硬件测试，及显示，压缩，音频的演示。报警部分演示请看DetectTt3v6.exe。
12. 和V11_Update3相比较，预览流报警没有更新。

                   S1000 V11 Update3 说明：
本更新是对S1000 V11(包括Update1,或Update2)版的更新,为方便客户该版是一个完全版
主要更新为NT4，Win2000部分的更新.可直接更新V11以前各版。

1.修正了NT4，WIN2000下捕获音频时系统崩溃BUG。
2.修正了WIN2000下,有时报告找不到S1000卡的错误（ave.rec中记录物理内存影射失败）。
3.修正了NT4下，报告显示库Display.dll不支持Surface3接口问题,及表面丢失问题.
4.SSAPI库NT4，WIN2000下音频部分少量bug.
5.修正了TT3V6演示程序音频部分少量bug。
6.更新了硬件库SurvAPI.dll
7.新增报警演示APP NewDetect(WIN98).
8.对V10 基本sdk用户报警App的更新V10Update

更新模块:
驱动:surv.sys(NT4,WIN2000)
硬件库:surviont.dll;survapi.dll;sdrps1.dll;sdrps2.dll;
显示库:display.dll,display.h(用户接口未变);
报警库:detectdll.dll及detect接口.H(用户接口变化);
SSAPI:ssapi.dll,ssapi.h;(报警,音频接口变化);
应用:TT3V6,NewDetect,V10update



                    S1000 V11 Update2 说明：
（SSAPI v1.0 更新为V1.02说明：）
本更新包括了Update1(V1.01)更新,可直接更新V11版。
本更新重点是报警检测库，及应用部分的更新，报警部分有较大更新。
更新方法：直接将原V11版对应文件覆盖即可。
对SSAPI音频和报警部分，因少量接口变化（结构参数变化），相应用户APP可能需调整。

1.更改了SSAPI使用压缩回调函数时，在停止压缩时可能出现的一个BUG。
2.音频部分增加了L，R声道选择，因而ssapi.h略有变化(sapiPlayPCMAudioFile函数参数变化)。
3.修正了回放音频文件的一个BUG。
4.修正了Display.dll显示库在显卡不支持OVERLAY时，程序出错问题。
SSAPI库直接更新：使用Release中的SSAPI.LIB及SSAPI.DLL，ssapi.h替换。
SSAPI原码更新：使用
ssapi.cpp,HWObj.h，ssapi.h,ssapi_audio.cpp等更新后的文件，将原文件覆盖即可。
Win98,Win2000,NT4相同。
5.修正了DEBUG版，不能启动捕获音频BUG。 
6.更新了SSAPI的报警检测部分，增加了一个报警检测检测APP演示程序NewDetect。
7.更新了基于基本SDK的V10版的报警检测部分。

                      S1000 V11 Update1 说明：
（SSAPI v1.0 更新为V1.01说明：）
1.更改了SSAPI使用压缩回凋函数时，在停止压缩时可能出现的一个BUG。
2.音频部分增加了L，R声道选择，因而ssapi.h略有变化(sapiPlayPCMAudioFile函数参数变化)。
3.修正了回放音频文件的一个BUG。
4.修正了Display.dll显示库在显卡不支持OVERLAY时，程序出错问题。
直接使用Release中的SSAPI.LIB及SSAPI.DLL，ssapi.h替换。
ssapi.cpp,HWObj.h，ssapi.h,ssapi_audio.cpp是更新后的文件，将原文件覆盖即可。
Win98,Win2000,NT4相同。 


                      S1000 V11 版说明：

1. 增加了S1000 Simple API 简称SSAPI，它封装了S1000 SDK的常用功能，及函数。大大简化，并加快了
   用户对S1000卡的开发.对S1000新用户建议使用SSAPI开发S1000卡。并将硬件库，显示库，报警库
   及.h文件从应用程序抽出，放在独立目录中，便于管理。
   详见SimpAPI.TXT. S1000DLL.DLL已无必要使用。
2. 该开发包包含完整的S1000开发SDK：
   DOC 为说明文档
   NT_WIN2000 为NT4和Win2000 Driver 及SDK
   WIN98 为Win98 的Driver 及SDK 
      SSAPI 为SSAPI.DLL V1.0 的源代码(VC++6下开发)。
      TT3V6为演示，测试程序，演示SSAPI的使用，release下为可执行程序。
   c++builder5 为一个使用SSAPI动态DLL加载的C++ Builder5开发的演示程序
   SSAPI\HWLib是S1000   V11硬件库(V10升级)。
   SSAPI\Display是S1000 V11显示库(V10升级)。
   SSAPI\DETECT是S1000  V11报警检测库(V10升级，接口有少量变化)。
3.原使用基本S1000 SDK 的用户可已继续使用，仅需升级硬件库和显示库，报警库   V10升级到V11：见READMEV11.TXT, simpapi.txt.
  SSAPI则可供参考。