迅驰-系统SDK设计文档.doc

《迅驰-系统SDK设计文档.doc》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、系统SDK说明文档(2004-12-3v1.2)我们的SDK分成三部分，分别为系统SDK、网络SDK、播放SDK，本文档专门描述系统SDK。系统SDK是专门为三洲迅驰各系列压缩卡设计的录像、预览、动态帧测、视频参数、OSD、LOGO等软件接口，以动态连接库的形式提供给应用软件开发商进行开发，并同时附有演示程序及其源代码，能有效地缩短应用软件的开发周期。本开发包包含有以下几个文件：SysSdk.dll系统开发包动态连接库；SysSdk.lib相应的静态连接库；SysApi.h函数说明头文件；TypeData.h数据结构及宏定义头文件。

2、1.2版本的改进部分修改了V1.0运动帧测不够准确的问题，相应的也增加了一套运动帧测函数，这些函数调用没有固定的调用顺序,函数如下：启动运动检测:StartMotionDetectionEx停止运动检测：StopMotionDetectionEx设置运动检测区域:SetupMotionDetectionEx调整动态帧测的灵敏度和阀值:AdjustMotionDetectPrecisionEx注册运动帧测的窗口句柄和消息RegisterMotionDetectionMessageV1.0的一些函数也保留下来，建议用户不要使用，这些函数

3、包括如下：启动运动检测:StartMotionDetection停止运动检测：StopMotionDetection设置运动检测区域:SetupMotionDetection调整动态帧测的灵敏度和阀值:AdjustMotionDetectPrecision分析动态帧测数据：MotionAnalyzer还增加了低照度报警功能：调整低照度报警敏度：AdjustCoveredPrecision相应的报警信号由调用GetVideoSignal返回一本SDK使用的错误代号定义及说明错误号解释INVALID_CHANNEL_HANDLE无效的通

4、道句柄;INVALID_DEVICE_HANDLE无效设备句柄;INVALID_PARAMETER无效的参数COULD_NOT_OPEN_FILE给定的文件无法打开COULD_NOT_CREATE_FILE创建文件失败COULD_NOT_SUPPORT_FORMAT不支持的图象格式PREVIEW_NOT_START预览还没开始HARDWARE_SYSTEM_ERROR硬件系统出错COULD_NOT_SUPPORT_OVERLAY不能支持OverlayQUEUE_BUFFER_OVERFLOW内部的数据对列溢出OUT_OF_MEMOR

5、Y提供的缓存大小不够DEVICE_HAVE_CLOSED设备已经关闭或者设备超出二函数说明2.1intInitDevices();说明：初始化全部板卡，应在应用软件启动时完成，如果返回值为0表明初始化失败，可能是没找到相应的板卡,只要运行这个函数之后其它的所有函数才会运行成功；返回：初始化成功的设备个数；2.2intDeInitDevices();说明：关闭每块板卡上功能，应在程序退出时调用；返回：返回关闭设备个数；2.3HANDLEDeviceOpen(intiDeviceNum);说明：打开设备，获取相关的设备句柄，与设备相关的

6、操作必须使用该句柄；参数：iDeviceNum设备号（从0开始）；返回：成功时返回设备句柄(可能是0)，失败时返回0xFFFFFFFF;2.4intDeviceClose(HANDLEhDeviceHandle)说明：关闭设备，释放相关资源,在程序中不关闭也可以，退出时SDK自动关闭。参数：HANDLEhDeviceHandle设备句柄返回：正确为ADT_SUCCESS(0)，错误返回INVALID_DEVICE_HANDLE,说明这个设备句柄不存在或无效的设备句柄；2.5HANDLEGetChannelHandle(intiCha

7、nnelNum);说明：获取通道句柄，与通道相关的操作必须使用该句柄,此通道所在设备的设备句柄没有打开也可以调用该函数。参数：iChannelNum通道号（从0开始）；返回：成功时返回通道句柄(可能为0)，失败时返回0xFFFFFFFF,说明通道号超出实际的通道个数;2.6intGetTotalChannels()返回：获取系统内可使用的通道个数，如果返回小于系统中安装的通道数，表明有某个设备初始化失败；2.7intGetTotalDevices();返回：获取系统内正确安装的设备个数，如果返回小于系统中安装的设备数，表明有某个设备

8、初始化失败；2.8HANDLEChangeChannelToDevice(HANDLEhChannelHandle)说明：获得通道所在设备句柄参数：hChannelHandle已知的通道句柄返回：已知通道所在的设备句柄2.9intSt