迅驰 系统SDK的设计文档.docVIP

系统SDK说明文档 (2004-12-3 v1.2) 我们的SDK分成三部分，分别为系统SDK、网络SDK、播放SDK，本文档专门描述系统SDK。系统SDK是专门为三洲迅驰各系列压缩卡设计的录像、预览、动态帧测、视频参数、OSD、LOGO等软件接口，以动态连接库的形式提供给应用软件开发商进行开发，并同时附有演示程序及其源代码，能有效地缩短应用软件的开发周期。 本开发包包含有以下几个文件： SysSdk.dll 系统开发包动态连接库； SysSdk.lib 相应的静态连接库； SysApi.h 函数说明头文件； TypeData.h 数据结构及宏定义头文件。 1.2版本的改进部分 修改了V1.0运动帧测不够准确的问题，相应的也增加了一套运动帧测函数，这些函数调用没有固定的调用顺序, 函数如下： 启动运动检测: StartMotionDetectionEx 停止运动检测：StopMotionDetectionEx 设置运动检测区域:SetupMotionDetectionEx 调整动态帧测的灵敏度和阀值 :AdjustMotionDetectPrecisionEx 注册运动帧测的窗口句柄和消息RegisterMotionDetectionMessage V1.0的一些函数也保留下来，建议用户不要使用，这些函数包括如下： 启动运动检测: StartMotionDetection 停止运动检测：StopMotionDetection 设置运动检测区域:SetupMotionDetection 调整动态帧测的灵敏度和阀值 : AdjustMotionDetectPrecision 分析动态帧测数据：MotionAnalyzer 还增加了低照度报警功能： 调整低照度报警敏度：AdjustCoveredPrecision 相应的报警信号由调用GetVideoSignal返回 一 本SDK使用的错误代号定义及说明 错误号 解释 INVALID_CHANNEL_HANDLE 无效的通道句柄; 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 不能支持Overlay QUEUE_BUFFER_OVERFLOW 内部的数据对列溢出 OUT_OF_MEMORY 提供的缓存大小不够 DEVICE_HAVE_CLOSED 设备已经关闭或者设备超出 二 函数说明 2.1 int InitDevices(); 说明：初始化全部板卡，应在应用软件启动时完成，如果返回值为0表明初始化失败， 可能是没找到相应的板卡,只要运行这个函数之后其它的所有函数才会运行成功； 返回：初始化成功的设备个数； 2.2 int DeInitDevices(); 说明：关闭每块板卡上功能，应在程序退出时调用； 返回：返回关闭设备个数； 2.3 HANDLE DeviceOpen(int iDeviceNum); 说明：打开设备，获取相关的设备句柄，与设备相关的操作必须使用该句柄； 参数：iDeviceNum设备号（从0开始）； 返回：成功时返回设备句柄(可能是0)，失败时返回0xFFFFFFFF; 2.4 int DeviceClose(HANDLE hDeviceHandle) 说明：关闭设备，释放相关资源,在程序中不关闭也可以，退出时SDK自动关闭。 参数：HANDLE hDeviceHandle 设备句柄 返回：正确为ADT_SUCCESS(0)，错误返回INVALID_DEVICE_HANDLE,说明这个设备句柄不存在或无效的设备句柄； 2.5 HANDLE GetChannelHandle(int iChannelNum); 说明：获取通道句柄，与通道相关的操作必须使用该句柄,此通道所在设备的设备句柄没有打开也可以调用该函数。 参数：iChannelNum通道号（从0开始）； 返回：成功时返回通道句柄(可能为0)，失败时返回0xFFFFFFFF,说明通道号超出实际的通道个数; 2.6 int GetTotalChannels() 返回：获取系统内可使用的通道个数，如果返回小于系统中安装的通道数，表明有某个设备初始化失败； 2.7 int GetTota