同三维VGA采集卡T100E开发手册.docVIP

VGA视频采集卡SDK API手册 2009.01 目录 1 概述 5 1.1 版本说明 5 2 SDK API函数说明 5 2.1 RGBCaptureInitialise 5 2.2 RGBCaptureOpen 5 2.3 RGBCaptureClose 6 2.4 RGBCaptureEnable 6 2.5 RGBCaptureGetParameters 7 2.6 RGBCaptureSetParameters 8 2.7 RGBCaptureDetectVideoMode 9 2.8 RGBCaptureUseMemoryBuffer 10 2.9 RGBCaptureReleaseBuffer 11 2.10 RGBCaptureFrameBufferReady 11 3 数据结构说明 12 3.1 RGBCAPTUREPARMS 12 Size 13 Flags 13 Input 13 Format 13 VideoTimings 13 Phase 13 Brightness 13 Contrast 14 BlackLevel 14 SampleRate 14 PixelFormat 14 SyncEdge 14 HorScale 14 HorOffset 15 VerOffset 15 HWnd 15 HScaled VScaled 15 NotifyFn NotifyArg 15 NotifyFlags 15 3.2 VDIF 15 Flags 16 HorAddrTime 16 HorRightBorder 16 HorFrontPorch 16 HorSyncTime 17 HorBackPorch 17 HorLeftBorder 17 VerAddrTime 17 VerBottomBorder 17 VerFrontPorch 17 VerSyncTime 17 VerBackPorch 17 VerTopBorder 17 Description 17 3.3 回调事件 18 RGBWM_FRAMECAPTURED 18 RGBWM_NOSIGNAL 18 RGBWM_MODECHANGED 18 RGBWM_INTERNALERROR 18 4 VGA采集显示VC例子 18 4.1 VGA采集显示程序流程 18 4.2 VC例子代码简释 19 概述 本手册有三部分组成。第一部分是SDK API函数手册；第二部分是SDK 数据结构说明；第三部分是VGA采集显示VC例子及简释。 版本说明 第一个版本API手册。 SDK API函数说明 RGBCaptureInitialise //函数名： RGBCaptureInitialise //功能描述： 获取当前电脑中已安装的，并可正常工作的VGA视频采集总数 //输入参数： 无 //输出参数： lpNumberOfDevices 返回设备总数 //返回值： 错误码 RGBERROR __stdcall RGBCaptureInitialise ( unsigned long FAR *lpNumberOfDevices /*返回设备总数*/ ) RGBCaptureInitialise函数用来获取当前电脑中已安装的，并可正常使用的VGA视频采集卡总数。 如电脑总安装有2块VGA视频采集卡，调用本函数则得到VGA视频采集卡设备数为2，也就是lpNumberOfDevices值为2。 如果函数调用成功，返回RGBERROR_NO_ERROR即0值；否则返回RGBERROR_HARDWARE_NOT_FOUND，表示没有找到VGA视频采集卡。 如确定电脑中安装的VGA视频采集卡数量，并确定设备安装正确，则可以不调用该函数。 RGBCaptureOpen //函数名：RGBCaptureOpen //功能描述：初始化指定的VGA视频采集卡，返回设备句柄 //输入参数： deviceIndex 输入需要初始化的设备号，从0开始 //输出参数： lpHRGBCapture 返回设备句柄 //返回值： 错误码 RGBERROR __stdcall RGBCaptureOpen ( unsigned long deviceIndex, // 设备号,从0开始 LPHRGBCAPTURE lpHRGBCapture // 返回打开的设备句柄 ) RGBCaptureOpen函数用来打开指定的VGA视频采集卡，并返回此设备的句柄。对VGA视频采集卡进行任何操作前，需要先调用此函数一次，并获得设备句柄。deviceIndex 参数指定需要打开的VGA视频采集卡卡号，取值范围是0到（lpNumberOfDevices - 1），其中l