同三维T301专业USB视频采集卡使用说明.doc

作者：同三维视频 编辑整理 同三维视频：1、T301专业USB视频采集卡同三维T301是一款USB接口的视频采集设备，其单卡带有3路Video视频、1路S端子视频信号，可以任选一路进行采集，可将输入的模拟视音频信号捕捉成清晰细腻的动态或者静态画面。产品功能完善，性能稳定，采集质量佳。并免费提供二次开发包，以满足不同用户的使用需求。并能支持市场上大多数视频采集软件进行视频采集和压缩，提供标准的二次开发包SDK，让用户可以轻松录制网上流行的WMV，MPEG-4,H.264等格式文件，也能针对需求进行自主开发。图示：同三维T301 专业USB视频采集盒一键抓拍功能同三维SDK(USB视频采集盒)的功能强劲，安装方便，它只需要USB接口供电，完全不用外接电源。并且兼容性出色，品质优秀，其图像质量也清晰佳。尤以一键抓拍功能更具特色，人性化设计。在视频会议、交通违章抓拍、停车场车牌抓拍、医疗影像分析、电子报名、大头贴、安防监控等领域起到很好的作用。用于各种视频接入的相关开发。USB2.0 高速接口同三维SDK(USB视频采集卡)采用USB接口设计，安装简便，免除了开拆电脑主机箱的繁琐，并且携带方便。USB2.0高速接口，让采集画面流畅、稳定。四路视频输入同三维SDK(USB视频采集卡)支持四路视频输入(3路Video视频、1路S端子)。可以通过软件在各路中切换浏览。提供二次开发包同三维SDK(USB视频采集卡开发二次开发包(SDK)，支持用户根据所需要求自行定制，以满足不同用户的需求。技术参数：l USB2.0接口，支持热插拔，支持笔记本电脑使用l 自行调整画面大小、最高分辨率可达720576，24位真彩色;l 支持Video视频、S端子视频l 图像亮度、对比度、饱和度、色度可自定义;l 可捕捉高品质动态及静态画面，采集画面顺畅不间断;l 具有一键抓拍功能、能实时对高速画面进行抓拍、最多可以同时抓拍25涨图片l 软件支持WMV，MPEG-4，H.264等高压缩比较文件压缩和实时流直播，方便进行个人，企业流媒体影象制作;l 无缝支持第三方通用软件进行MPEG1/2等多种实时压缩格式，方便制作VCD/SVCD/DVD;l 兼容WINDOW2000/XP/2003等操作系统，兼容Direct8.1、9.0;l 提示支持32位及64位操作系统标准WDM驱动;支持软件： 支持国内大多数视频会议软件，例如： AVCON视频会议软件、V2 Conference视频会议、北京网动视频会议、 支持Media Encoder, Helix Real Producer，Darwinserver 支持多种编码格式，包括：Wmv9，Rmvb,Rm，MPEG-4，DivX多格式视频编码，混合不同码率、分辨率的视频同步流畅输出及播放 多处理器(SMP)和超线程优化 实时预览，全文互式与处理硬件参数能力产品特点：1 体积小巧，流行外观设计。2 专业视频芯片并配有滤波设计。3 提供专业级图像品质，性能稳定，图像质量佳，CUP资源占用率低。4 提供3路Video视频、1路S端子输入。5 功能强劲，安装方便，不用外接电源，由USB接口供电。兼容性好6 一键抓拍，人性化设计 外观精致。7 提供完整SDK二次开发包及开发文档。系统需求： Intel Pentium4 2.0 GHz 或 Celeron 2.4 GHz CPU 以上.Windows 2000/XP/2003 128M RAM(推荐256MB)支持Directshow加速显卡 建议1GB 以上的硬盘空间，供软件存放影片档案一个空闲的USB2.0端口微软 DirectX 9.0 (Windows 2000 建议安装)微软 Media Player 7.1 (Windows 2000 建议安装Intel Pentium4 1.4G CPU。建议Pentium4 2.0G以上系统需求内存至少128M。建议256M。一个高速USB2.0接口支持DirectX9.0的显卡光驱(安装程序用)300MB可用之硬盘空间(安装驱动及应用程序，如(HandCap及DVD Studio)，加上每小时600MB到3GB的录像文件所需要的空间应用领域：野外图像采集及存储 实时图像采集处理分析 野外监控录像系统可视电话 电脑照相医学影像 汽车驾照 工业检测 医学内镜 保安监控 交通抓拍 公路收费 远程医疗 机器视觉细胞图谱 电化教学 美容美发 证卡制作 电脑画像 生物识别 人工智能 金融票证 电子警察机器视觉 病理显微 图象分析 文化体育等所有的视频图像显示、采集、分析领域。2、T301 USB视频采集卡驱动和应用软件安装下列安装过程在window XP系统中进行，其他安装程序可能略有不同，首先将T301 视频采集卡包装附带的光盘放入光驱中，并将T301 USB采集卡连接视频源以及电脑主机。这时在窗口右下角弹出找到新硬件的提示接着windows会弹出驱动安装向导提示连接网络搜索驱动，点“否，暂时不”后点击下一步提示安装驱动方式，点“从列表或指定位置”后点击下一步点击“浏览”在弹出的窗口中指向光驱所在盘符，在光盘目录下选中“Driver”文件夹后点击“确定”按钮正在检索驱动文件。弹出windows认证提示，点“仍然继续”后即开始安装驱动。稍等片刻即弹出驱动安装完成的提示，点“完成”这时驱动已安装完成，还需安装应用程序。T301 USB采集卡应用程序安装双击桌面“我的电脑”进入光盘目录下的Application文件夹。双击该文件下安装文件Setup.exe图标，运行软件安装程序。点击“Next”提示安装路径，如无须指定， 点击“Next”进入下一步提示设定安装目录名称，如无须指定， 点击“Next”进入下一步提示是否创建桌面快捷方式，如无须指定， 点击“Next”进入下一步点击“Install”进行安装稍等片刻即弹出驱动安装完成的提示，点“Finish”安装完成后便能启动T301 USB采集卡应用程序窗口，如下图这样T301 USB采集卡驱动以及应用软件已经安装完毕，您可以正常使用其所有功能。在安装前务必先仔细浏览产品包装中的说明书，这对使用和保养产品都是非常有帮助的。3、T301 USB采集卡应用软件功能介绍同三维推出的专业T301 USB视频采集卡功能强大，性能稳定，采集图像质量清晰。有3路Video视频、1路S端子来接入视频，一键抓拍，人性化设计。并且自带采集和操作软件，下面我们就这对这款软件功能和特点进行介绍。如应用软件界面(如下图)，带有定时录像和人工录像功能，方便了用户智能化对视频进行采集。这款USB视频采集卡的采集分辩率能达到768X576，支持无级缩放。我们再看下其他功能。视频抓拍：根据特殊应用，可以选择正常抓拍方法以及“水平镜像”或“垂直镜像”，USB视频采集卡上自带按钮抓拍，可以使用按钮或者鼠标点击操作，可对动态高速视频同时多张图片抓取(最多支持25张) ，并且自动保存，这样保证了抓取图像的清晰度。视频处理：可根据视频源的不同选择“顶场处理”或“底场处理”，根据De-interlace的不同处理方法，可选择“简单处理”、“普通处理”、“高级处理”，“视频直通”没有做任何的处理。OSD叠加：提供文字、时间、图片的叠加DEMO，满足用户不同需求，视频采集中可以随时进行编辑和操作，实时显示在计算机屏幕上。下面我们再对功能进行详细的介绍。点击查看大图其他属性设置窗口如下图视频属性：可根据实际情况调节亮度、色度、对比度、饱和度、清晰度视频设置：视频制式选择PAL/NTSE/SECAM，数据采集选择原始/压缩，视频源可在AV1/AV2/AV3/S-video中切换。视频尺寸：可根据实际需求调整，支持无级缩放。视频翻转：提供特殊应用的预览图像倒置。定时录像窗口如下图可设置定时录像的起始时间与录像时长。OSD制作如下图，可选择时间型、文本型、图片型，对OSD进行自定义，实时对视频进行叠加处理。点击查看大图通过以上介绍，相信大家对这款USB视频采集卡的应用软件有了很清楚的了解，并且还提供完整的二次开发包SDK，可以快速开发您所需要的功能系统，其广泛应用于笔记本图像采集处理、视频会议、医学图像处理、视频监控、交通违章抓拍、停车场车牌抓拍、医疗影像分析、电子报名、大头贴等领域，是一款针对此类用户专业开发的多功能USB视频采集卡。4、T301 USB视频采集卡SDK环境说明T301 USB视频采集卡SDK函数说明 HYUtil.DLL 使用说明 (for VC+ 6.0)操作系统：Windows 2000/WinXp一、编译环境1、 将 HYUtil.lib Shlwapi.lib(系统文件) 文件加入工程设置的“Link General Object/library module”中。2、 在工程中包含HYUtil.h头文件。3、 将HYUtil.dll、RenderDraw.ax、YuvComplex.dll、yuvConvert.ax、yuvDeinterlace.ax、MediaCodec.dll 文件拷入到系统路径或搜索目录中。发布时，请注册yuvConvert.ax、yuvDeinterlace.ax、RenderDraw.ax到用户环境。4、 编写代码。二、函数说明：1 数据常量介绍#define ERR_SUCCESS 0 说明：函数成功调用。#define ERR_FAILED 1 说明：函数调用过程中出现未知错误。#define ERR_NOTAVAILABLE 2 说明：函数调用无效，多发生于执行环境错误的场合。#define ERR_NODEVICE 101 说明：没有发现有效的USB采集设备。#define ERR_DIRECTX_SETUP 102 说明：在设备操作过程中，出现了DirectX运行错误，通常由DirectX版本太低引起。#define ERR_DEV_NOTOPEN 104 说明：设备处于关闭状态，不能对其进行操作。#define ERR_NOTSUPPORT 105 说明：功能调用目前不被支持。#define ERR_GRAPH_CONNECT 107 说明：Filter连接过程出现错误。#define ERR_DEVICE_RUN 108 说明：Graph 不能按要求运行。#define ERR_NOT_MEMIMG 109 说明：不是本系统支持的内存印像#define ERR_SNAPSHOT_END 200 说明：快照操作已终止的情况下调用HYGetSnapShot返回的错误#define ERR_WAIT_TIMEOUT 201 说明：操作等待超时。#define ERR_BUFFER_TOOSMALL 202 说明：用户分配的缓冲区太小，不足以完成当前操作。#define ERR_DEVICE_STATE 203 说明：当前设备状态不允许对其进行指定操作。#define ERR_INSUFFICIENT_RESOURCES 204 说明：系统资源不足，多发生于内存资源不足。#define ERR_INVALID_PARAM 205 说明：无效的函数调用参数。2.3 SDK 导出函数说明：UINT WINAPI HYInitialize()说明：初始化SDK，建立系统运行所需要的环境。参数：无返回：ERR_SUCCESS：成功。其他：失败。失败原因由返回值给出。void WINAPI HYUninitialize()说明：反初始化SDK，释放系统资源。参数：无返回：无int WINAPI HYGetDevCnt()说明：获取本系统安装的USB采集设备数量。参数：无返回：采集设备数量，如小于等于0，则表示没有检测到采集设备。4 UINT WINAPI HYOpenDev(UINT unIndex)说明：打开USB采集设备，对设备进行各种操作之前都必需先打开设备。参数：UINT unIndex：基于0的设备索引，范围0 -(MaxDevCount-1)返回：ERR_SUCCESS：成功。其他：操作失败。可能原因：1、无效的设备索引。2、DirectX操作失败。其他原因请参照返回代码。UINT WINAPI HYCloseDev(UINT unIndex)说明：关闭采集设备，释放系统资源。参数：UINT unIndex：基于0的设备索引，范围0 -(MaxDevCount-1)返回：ERR_SUCCESS：成功。其他：操作失败。失败原因由返回代码给出。6 UINT WINAPI HYPortSpeed(UINT unIndex,BOOL &bHighSpeedPort)说明：获取USB端口速度。参数：UINT unIndex： 基于0的设备索引，范围0 -(MaxDevCount-1)BOOL &bHighSpeedPort: 输出参数，返回用户USB设备所对应端口的操作速度。TRUE :端口满足USB 2.0接口规范,为高速端口FALSE:端口满足USB 1.1接口规范,为低速端口返回：ERR_SUCCESS：成功。其他：操作失败。失败原因由返回代码给出。7 UINT WINAPI HYSetOwnerWnd(UINT unIndex,HWND hWnd)说明：设置视频输出窗口。参数：UINT unIndex：基于0的设备索引。HWND hWnd：视频输出窗口，亦即用户看到视频图像的窗口。返回：ERR_SUCCESS：操作成功。其他：操作失败，错误原因由返回代码给出。8 UINT WINAPI HYStartDevice(UINT unIndex)说明：运行设备，开始进行数据采集(用于各项采集参数设置完成后)。参数：UINT unIndex：基于0的设备索引。返回：ERR_SUCCESS：操作成功。其他：操作失败，错误原因由返回代码给出。9 UINT WINAPI HYStopDevice(UINT unIndex)说明：停止设备，数据采集过程结束。参数：UINT unIndex：基于0的设备索引。返回：ERR_SUCCESS：操作成功。其他：操作失败，错误原因由返回代码给出。10 UINT WINAPI HYGetVideoPropRange(UINT unIndex,VIDEOPROP enProp,int &nMax,int &nMin,int &nDefault)说明：获取亮度/色度/对比度等属性指标的参数范围。参数：UINT unIndex：基于0的设备索引。VIDEOPROP enProp：待查询参数范围的视频属性。(VIDEOPROP的说明如前述)int & nMax：输出参数，对应于enProp属性所能选取的最大值。int & nMin：输出参数，对应于enProp属性所能选取的最小值。int & nDefault：输出参数，对应于enProp属性的系统默认值。返回：ERR_SUCCESS：操作成功。其他：操作失败，错误原因由返回代码给出。11 UINT WINAPI HYGetVideoProp(UINT unIndex,VIDEOPROP enProp,int &nValue)说明：获取视频显示属性的当前设置值，包括亮度/色度/饱和度/对比度/清晰度等。参数：UINT unIndex：基于0的设备索引。VIDEOPROP enProp ：需获取的视频属性。int &nValue ：输出参数，用于返回当前视频显示属性值定义：1、视频属性typedef enum VIDEO_BRIGHTNESS = 1, /视频亮度， 默认值 128VIDEO_CONTRAST, /视频对比度， 默认值 68VIDEO_HUE, /视频色度， 默认值 0VIDEO_SATURATION, /视频饱和度， 默认值 64VIDEO_SHARPNESS /视频锐度， 默认值 0VIDEOPROP;返回：ERR_SUCCESS：操作成功，当前视频显示属性值由nValue变量返回。其他：操作失败。可能原因：1、无效的设备索引2、设备没有成功执行Open操作其他失败原因请参照返回代码。12 UINT WINAPI HYSetVideoProp(UINT unIndex,VIDEOPROP enProp,int nValue)说明：设置视频显示属性值，包括亮度/色度/饱和度/对比度/清晰度等。参数：UINT unIndex：基于0的设备索引。VIDEOPROP enProp ：需设定的视频属性，参见前述对VIDEOPROP的说明LONG nValue ：设定的视频属性值，范围请参见HYGetVideoPropRange的返回值返回：ERR_SUCCESS：成功。其他：操作失败。可能原因：1、无效的设备索引2、设备没有成功执行Open操作3、视频属性值超过设置范围。其他失败原因请参照返回代码。13 UINT WINAPI HYGetVideoSize(UINT unIndex,UINT &unSizeX,UINT &unSizeY)说明：获取当前视频采集尺寸。参数：UINT unIndex：基于0的设备索引。UINT &unSizeX：输出参数，用于返回当前视频采集尺寸的宽度。UINT &unSizeY：输出参数，用于返回当前视频采集尺寸的高度。返回：ERR_SUCCESS：成功。其他：操作失败。失败原因由返回代码给出。14 UINT WINAPI HYSetVideoSize(UINT unIndex,UINT unSizeX,UINT unSizeY)说明：设置视频采集尺寸。该操作应该在设备停止状态下进行。参数：UINT unIndex：基于0的设备索引。UINT unSizeX：视频采集尺寸的宽度。UINT unSizeY：视频采集尺寸的高度。返回：ERR_SUCCESS：成功。其他：操作失败。失败原因由返回代码给出。15 UINT WINAPI HYGetVideoFmt(UINT unIndex,VIDEOFMT &enFmt)说明：获取当前视频采集格式。参数：UINT unIndex：基于0的设备索引。VIDEOFMT &enFmt：输出参数，返回当前视频采集格式，可能的格式包括YUY2和Y41P。定义：1、视频格式typedef enum FMT_YUY2 = 1, /YUY2包模式FMT_Y41P, /Y41P包模式FMT_RGB,FMT_UNKNOWNVIDEOFMT;返回：ERR_SUCCESS：成功。其他：操作失败。失败原因由返回代码给出。16 UINT WINAPI HYSetVideoFmt(UINT unIndex,VIDEOFMT enFmt)说明：设置视频采集格式。该操作应该在设备停止状态下进行。参数：UINT unIndex：基于0的设备索引。VIDEOFMT enFmt：视频采集格式。目前支持选项包括FMT_YUY2和FMT_Y41P。返回：ERR_SUCCESS：成功。其他：操作失败。失败原因由返回代码给出。17 UINT WINAPI HYGetVideoStd(UINT unIndex,VIDEOSTD &enStd)说明：获取视频信号输入标准。参数：UINT unIndex：基于0的设备索引。VIDEOSTD &enStd： 输出参数，用于返回当前视频信号输入标准。定义：1、视频标准typedef enum STD_PAL = 1, /PAL 制式， 帧率最大25 fpsSTD_NTSC, /NTSC制式， 帧率最大30 fpsSTD_SECAM, /SECAM制式，帧率最大25 fpsSTD_UNKNOWVIDEOSTD;返回：ERR_SUCCESS：操作成功，当前视频标准由enStd变量返回。其他：操作失败。失败原因由返回代码给出。18 UINT WINAPI HYSetVideoStd(UINT unIndex,VIDEOSTD enStd)说明：设置视频信号输入标准。参数：UINT unIndex：基于0的设备索引。VIDEOSTD enStd： 新的视频信号输入标准，请参见前述对VIDEOSTD的说明返回：ERR_SUCCESS：成功。其他：操作失败。失败原因由返回代码给出。19 UINT WINAPI HYGetScanMode(UINT unIndex,SCANMODE &enScanMode)说明：获取视频信号的当前采集模式，包括帧和场两种方式。参数：UINT unIndex：基于0的设备索引。SCANMODE &enScanMode：输出参数，用于返回当前的采集模式，系统通常工作在帧采集模式下。定义：1、采集模式：typedef enum SCAN_FIELD = 1, /单场采集模式，不用做反交错处理SCAN_FRAME /帧采集模式，奇偶场信号均被采集，需进行进行反交错处理以消除拉丝现象。SCANMODE;返回：ERR_SUCCESS：成功。其他：操作失败。失败原因由返回代码给出。20 UINT WINAPI HYSetScanMode(UINT unIndex,SCANMODE enScanMode)说明：设置视频信号的当前采集模式，包括帧和场两种方式。参数：UINT unIndex：基于0的设备索引。SCANMODE enScanMode：新的视频采集模式，可能的选项包括帧模式和场模式。返回：ERR_SUCCESS：成功。其他：操作失败。失败原因由返回代码给出。21 UINT WINAPI HYGetVideoSrc(UINT unIndex,VIDEOSRC &enSrc)说明：获取当前视频源设置。参数：UINT unIndex：基于0的设备索引。VIDEOSRC & enSrc：输出参数，用于返回当前视频源设置。视频源请参见前述VIDEOSRC说明。返回：ERR_SUCCESS：成功。其他：操作失败。失败原因由返回代码给出。22 UINT WINAPI HYSetVideoSrc(UINT unIndex,VIDEOSRC enSrc,BOOL bSafeSwitch)说明：设置当前视频源。(建议在设备处于停止状态时调用)参数：UINT unIndex：基于0的设备索引。VIDEOSRC enSrc：待设置的视频源。BOOL bSafeSwitch：安全设置开关。TRUE：如果设备当前处于运行状态，函数将返回ERR_DEVICE_STATE错误值。FALSE：不对设备状态进行检测，直接完成设置视频源操作。定义：1、视频源：typedef enum SRC_AV1 = 1, /AV1,系统默认视频源SRC_AV2, /AV2SRC_AV3, /AV3SRC_AV4, /AV4SRC_SV1 /SV1VIDEOSRC;返回：ERR_SUCCESS：成功。其他：操作失败。失败原因由返回代码给出。23 UINT WINAPI HYVideoPresent(UINT unIndex,BOOL &bVideoPresent)说明：获取视频信号状态，以确定当前是否有视频信号存在。参数：UINT unIndex：基于0的设备索引。BOOL &bVideoPresent：输出参数，用于返回当前视频信号状态。为TRUE表示有信号，FALSE表示无信号返回：ERR_SUCCESS：操作成功，视频信号状态由变量bVideoPresent返回。其他：操作失败。失败原因由返回代码给出。24 UINT WINAPI HYGetProcMethod(UINT unIndex,PROCMETHOD &enMethod)说明：获取设备当前采用的视频处理方法。(视频反交错处理方法)参数：UINT unIndex：基于0的设备索引。PROCMETHOD &enMethod：输出参数，用于返回当前视频处理方法。定义：1、视频处理方法typedef enum METHOD_SAMPLE = 1, /简单处理方法METHOD_NORMAL, /基本处理方法METHOD_COMPLEX, /高级处理方法METHOD_PASS, /视频数据直通METHOD_UNKNOWNPROCMETHOD;返回：ERR_SUCCESS：操作成功。其他：操作失败。失败原因由返回代码给出。25 UINT WINAPI HYSetProcMethod(UINT unIndex,PROCMETHOD enMethod)说明：设置设备视频处理方法。(视频反交错处理方法)参数：UINT unIndex：基于0的设备索引。PROCMETHOD enMethod：待设置的新的视频处理方法。请参见HYGetProcMethod函数说明。返回：ERR_SUCCESS：操作成功。其他：操作失败。失败原因由返回代码给出。26 UINT WINAPI HYGetFieldSeq(UINT unIndex,BOOL &bTopFieldFirst)说明：获取设备当前采用的场处理顺序。(用于视频反交错处理)参数：UINT unIndex：基于0的设备索引。BOOL &bTopFieldFirst：输出参数，用于返回当前采用的场处理顺序。TRUE：顶场优先FALSE：底场优先返回：ERR_SUCCESS：操作成功。其他：操作失败。失败原因由返回代码给出。27 UINT WINAPI HYSetFieldSeq(UINT unIndex,BOOL bTopFieldFirst)说明：设置设备当前采用的场处理顺序。(用于视频反交错处理)参数：UINT unIndex：基于0的设备索引。BOOL bTopFieldFirst：新的场处理顺序。TRUE：顶场优先，FALSE：底场优先返回：ERR_SUCCESS：操作成功。其他：操作失败。失败原因由返回代码给出。28 UINT WINAPI HYReadEprom (UINT unIndex,PBYTE pBuffer,UINT nStartPos,UINT nLen)说明：读出Eeprom中特定位置的内容信息。参数：UINT unIndex：基于0的设备索引。PBYTE pBuffer：用户申请的缓冲区地址，用于保存读出的Eeprom内容。UINT nStartPos：待读出内容的Eeprom子地址，取值范围0-127。UINT nLen：请求读出的信息长度，以字节为单位。返回：ERR_SUCCESS：操作成功。其他：操作失败。失败原因由返回代码给出。29 UINT WINAPI HYWriteEprom(UINT unIndex,PBYTE pBuffer,UINT nStartPos,UINT nLen)说明：读出Eeprom中特定位置的内容信息。参数：UINT unIndex：基于0的设备索引。PBYTE pBuffer：保存有待写入Eeprom信息的用户缓冲区地址。UINT nStartPos：待写入Eeprom的子地址偏移，取值范围0-127。(建议用户不要随意修改前16字节内容)UINT nLen：待写入的信息长度，以字节为单位。返回：ERR_SUCCESS：操作成功。其他：操作失败。失败原因由返回代码给出。30 UINT WINAPI HYSetPlayEffect (UINT unIndex,VIDEOEFFECT enEft)说明：设置视频播放效果。参数：UINT unIndex：基于0的设备索引。VIDEOEFFECT enEft：待设置的视频播放效果。定义：1、视频播放效果typedef enumEFT_NORMAL = 1, /普通显示效果EFT_GOOD /增强显示效果(更流畅、清晰，但会占用更多的CPU资源)VIDEOEFFECT;返回：ERR_SUCCESS：操作成功。其他：操作失败。失败原因由返回代码给出。31 UINT WINAPI HYGetSnapRect(UINT unIndex,long &nLeft,long &nTop,long &nRight,long &nBottom)说明：获取当前快照矩形设置。(定义：视频区域左上角坐标为(0，0)，从左往右为x正向，由上到下为y正向)参数：UINT unIndex：基于0的设备索引。long & nLeft：输出参数，用于返回快照矩形相对于坐标原点的左边位置long & nTop：输出参数，用于返回快照矩形相对于坐标原点的上边位置long & nRight：输出参数，用于返回快照矩形相对于坐标原点的右边位置long &nBottom：输出参数，用于返回快照矩形相对于坐标原点的下边位置返回：ERR_SUCCESS：操作成功。其他：操作失败。失败原因由返回代码给出。32 UINT WINAPI HYSetSnapRect(UINT unIndex,long nLeft, long nTop, long nRight, long nBottom)说明：设置快照矩形。(定义：视频区域左上角坐标为(0，0)，从左往右为x正向，由上到下为y正向)参数：UINT unIndex：基于0的设备索引。long nLeft：左，详细定义参见函数说明HYGetSnapRectlong nTop：上，详细定义参见函数说明HYGetSnapRectlong nRight：右，详细定义参见函数说明HYGetSnapRectlong nBottom：下，详细定义参见函数说明HYGetSnapRect返回：ERR_SUCCESS：操作成功。其他：操作失败。失败原因由返回代码给出。33 UINT WINAPI HYMirrorHorizon (UINT unIndex,BOOL bMirrorHorizon)说明：设置图片快照水平镜象。参数：UINT unIndex：基于0的设备索引。BOOL bMirrorHorizon：快照图片水平镜象设置。TRUE：对快照图片进行水平翻转FALSE：不对快照图片进行水平镜象(系统默认)返回：ERR_SUCCESS：操作成功。其他：操作失败。失败原因由返回代码给出。34 UINT WINAPI HYMirrorVertical(UINT unIndex,BOOL bMirrorVertical)说明：设置图片快照垂直镜象。参数：UINT unIndex：基于0的设备索引。BOOL bMirrorHorizon：快照图片垂直镜象设置。TRUE：对快照图片进行垂直翻转FALSE：不对快照图片进行垂直镜象(系统默认)返回：ERR_SUCCESS：操作成功。其他：操作失败。失败原因由返回代码给出。35 UINT WINAPI HYPreAllocBuf(UINT unIndex,long nPreAllocFrames)说明：设置预分配帧缓冲数量。参数：UINT unIndex：基于0的设备索引。long nPreAllocFrames：预分配帧缓冲数量，取值范围3-100(默认值3)系统需要进行帧缓冲的预分配以进行连续抓拍，建议谨慎调整返回：ERR_SUCCESS：操作成功。其他：操作失败。失败原因由返回代码给出。36 UINT WINAPI HYGetAllocBuf(UINT unIndex,long *nAllocFrames)说明：获取实际分配的帧缓冲数量。参数：UINT unIndex：基于0的设备索引。long * nAllocFrames：输出参数，用于返回实际分配的帧缓冲数量。返回：ERR_SUCCESS：操作成功。其他：操作失败。失败原因由返回代码给出。37 UINT WINAPI HYRegNotifyWnd(UINT unIndex,HWND hWnd,BOOL bOnlyKeyDown)说明：注册用于接收系统消息的通知窗口。参数：UINT unIndex：基于0的设备索引。BOOL bOnlyKeyDown：是否仅仅接收设备按键消息。TRUE：仅接收设备按键消息WM_SNAP_KEYDOWN。FALSE：接收所有系统通知消息，包括WM_SNAP_KEYDOWN和WM_VIDEODATA(可能消耗更多的系统资源，如无必要请不要选择该种方式)HWND hWnd：用于接收系统消息的通知窗口句柄。系统消息主要包括：WM_VIDEODATA： 当系统处于快照或回调状态，且采集到完整帧时发出该消息。WM_SNAP_KEYDOWN：当设备上的按键被按下时，系统发出该消息。返回：ERR_SUCCESS：操作成功。其他：操作失败。失败原因由返回代码给出。38 UINT WINAPI HYStartSnap(UINT unIndex,long nPictures,long nInterval)说明：开始图片快照。如果当前系统处于回调状态，函数调用将返回错误ERR_DEVICE_STATE。用户有两种方式获取图片快照，两种方式都需要先调用该函数以开始图片快照过程。其一：逐次调用HYGetMemSnap，以获取快照图片数据，直到获得需要的快照图片数量。编程形式如下：HYStartSnap(.)while(nPictures-)HYGetMemSnap(.);if(bNeedPaint)PaintMemImg(.);if(bNeedSave)SnapVideoImage(.);其二：通过响应系统消息WM_VIDEODATA来处理快照数据。前提是需要先注册消息通知窗口。ON_MESSAGE(WM_VIDEODATA,OnSnapCommit)LRESULT afx_msg OnSnapCommit(WPARAM wParam,LPARAM lParam);LRESULT OnSnapCommit(WPARAM wParam,LPARAM lParam)UINT unState = (UINT)wParam;if(unState = OPER_SNAPSHOT) /系统当前处于图片快照状态HYGetMemSnap(.);if(bNeedPaint)PaintMemImg(.);if(bNeedSave)SnapVideoImage(.);else /系统当前处于视频数据回调状态参数：UINT unIndex：基于0的设备索引。long nPictures：快照图片张数。long nInterval：快照时间间隔，单位：帧。返回：ERR_SUCCESS：操作成功。其他：操作失败。失败原因由返回代码给出。39 UINT WINAPI HYCancelSanp(UINT unIndex)说明：终止当前快照操作过程。参数：UINT unIndex：基于0的设备索引。返回：ERR_SUCCESS：操作成功。其他：操作失败。失败原因由返回代码给出。40 UINT WINAPI HYGetImgBufsize (UINT unIndex,long *pnSize,VIDEOFMT enFmt)说明：获取快照图片所需内存尺寸。参数：UINT unIndex：基于0的设备索引。VIDEOFMT enFmt：请求快照图片格式，目前支持FMT_YUY2和FMT_RGB两种。long *pnSize：输出参数，用于返回快照图片所需内存尺寸，用户可按照这个尺寸进行内存空间的分配。返回：ERR_SUCCESS：操作成功。其他：操作失败。失败原因由返回代码给出。41 UINT WINAPI HYGetMemSnap(UINT unIndex,BYTE *pImgBuf,long nSize,VIDEOFMT enFmt,DWORD dwTimeout)说明：获取快照数据。在超时设置dwTimeout时间范围内，该函数将处于阻塞状态。参数：UINT unIndex：基于0的设备索引。BYTE * pImgBuf：用于接收快照图片的用户缓冲区地址。long nSize：用户缓冲区尺寸，可通过HYGetImgBufsize函数获得。VIDEOFMT enFmt：请求快照图片格式，目前支持FMT_YUY2和FMT_RGB两种。DWORD dwTimeout：快照超时，单位毫秒。返回：ERR_SUCCESS：操作成功。其他：操作失败。失败原因由返回代码给出。42 UINT WINAPI HYPaintMemImg(BYTE *pImgBuf,long nSize,HWND hPaintWnd)说明：显示快照图片到指定绘画窗口，系统将接管该窗口的WM_PAINT消息，用户不用处理窗口重绘等消息。该函数必须结合HYEndPaint函数使用以结束绘画过程。参数：BYTE * pImgBuf：内存快照数据缓冲地址。通常由函数HYGetMemSnap获取快照数据。long nSize：缓冲区尺寸。HWND hPaintWnd：绘画窗口。返回：ERR_SUCCESS：操作成功。其他：操作失败。失败原因由返回代码给出。43 UINT WINAPI HYPaintDiskImg(LPCTSTR szFileName,HWND hPaintWnd)说明：显示存盘图片文件到绘画窗口，系统处理方法同HYPaintMemImg，该函数必须结合HYEndPaint函数使用以结束绘画过程。参数：LPCTSTR szFileName：磁盘文件名，包括全路径。HWND hPaintWnd：绘画窗口。返回：ERR_SUCCESS：操作成功。其他：操作失败。失败原因由返回代码给出。44 UINT WINAPI HYEndPaint(HWND hPaintWnd)说明：结束图片显示过程。参数：HWND hPaintWnd：绘画窗口。返回：ERR_SUCCESS：操作成功。其他：操作失败。失败原因由返回代码给出。45 UINT WINAPI HYSaveImgAsJpg(BYTE *pImgBuf,long nSize,LPCTSTR szJpgFileName,long nQuality)说明：将内存快照存为Jpg文件。参数：BYTE