1.11.3  视频采集卡常用函数

在购买具有SDK开发包的监控卡时，会附带有监控卡的使用手册，其中包含有SDK开发包的详细说明。下面以天敏VC4000监控卡为例，介绍其主要函数及开发流程。

天敏VC4000监控卡的SDK主要由Sa7134Capture.dll、MediaTransmit.dll、MPG4c32.dll、Sa7134Capture.lib、MediaTransmit.lib、Sa7134Capture.h和MediaTransmit.h等几个文件组成。在使用开发包提供的函数前，需要将这些文件添加到当前工程中。天敏VC4000监控卡的SDK包含了近百个函数，下面介绍开发视频监控经常使用的函数。

1．VCAInitSdk

该函数用于初始化开发包。在使用SDK开发包中的函数前，首先需要调用该函数进行初始化。

语法：

BOOL  WINAPI VCAInitSdk( HWND hWndMain, DISPLAYTRANSTYPE 
eDispTransType = 
PCI_VIEDOMEMORY, BOOL bInitAudDev = FALSE  );

hWndMain：表示视频显示多路小窗口的父窗口。

eDispTransType：表示显示类型。

bInitAudDev：表示是否初始化音频设备。

2．VCAUnInitSdk

该函数用于释放调用VCAInitSdk函数分配的系统资源，通常在程序结束时调用该函数。

语法：

void  WINAPI VCAUnInitSdk()

3．VCAGetDevNum

该函数用于获得监控卡中芯片的数量。通常，监控卡支持多少路视频，将会存在多少个芯片。

语法：

LONG  WINAPI VCAGetDevNum()

返回值：表示系统中安装监控卡上的芯片数量。

4．VCAOpenDevice

该函数用于打开视频预览窗口。

语法：

 BOOL  WINAPI VCAOpenDevice( DWORD dwCard,HWND hPreviewWnd )

dwCard：表示视频捕捉的卡号。

hPreviewWnd：表示视频预览窗口句柄。

5．VCAStartVideoPreview

该函数用于打开视频预览窗口。

语法：

 BOOL  WINAPI VCAStartVideoPreview( DWORD dwCard ) 

dwCard：表示预览的视频卡号。

6．VCAStopVideoPreview

该函数用于停止视频预览。

语法：

BOOL  WINAPI VCAStopVideoPreview( DWORD dwCard )

dwCard：表示停止预览的视频卡号。

7．VCAUpdateOverlayWnd

该函数用于更新视频预览窗口。当预览窗口的父窗口大小或位置改变时，需要调用该函数进行调整。

语法：

BOOL  WINAPI VCAUpdateOverlayWnd(HWND hOverlayWnd)

hOverlayWnd：表示预览窗口的父窗口。

8．VCAUpdateVideoPreview

该函数用于更新视频预览窗口。当预览窗口的大小和位置需要调整时调用该函数。通常，在调用该函数前，需要调用VCAUpdateOverlayWnd函数。

语法：

 BOOL  WINAPI VCAUpdateVideoPreview( DWORD dwCard, HWND hPreviewWnd )

dwCard：表示视频卡号。

hPreviewWnd：表示视频预览窗口。

9．VCASetVidCapSize

该函数用于设置视频捕捉的大小。

语法：

BOOL  WINAPI VCASetVidCapSize( DWORD dwCard, DWORD dwWidth, DWORD dwHeight )

dwCard：表示视频卡号。

dwWidth：视频捕捉图像的宽度，建议为16的整数倍。

dwHeight：视频捕捉图像的高度，建议为16的整数倍。

10．VCASetVidCapFrameRate

该函数用于设置视频捕捉帧率。

语法：

BOOL WINAPI VCASetVidCapFrameRate( DWORD dwCard, DWORD dwFrameRate,
BOOL bFrameRateReduction = FALSE )

dwCard：表示视频卡号。

dwFrameRate：表示设置的捕捉帧率，PCL信号最大帧率为25，NTSC最大帧率为30。

bFrameRateReduction：该参数是保留的，未被使用。

11．VCASetBitRate

该函数用于设置MPEG压缩的位率。

语法：

 BOOL  WINAPI VCASetBitRate( DWORD dwCard, DWORD dwBitRate)

dwCard：表示视频卡号。

dwBitRate：表示MPEG的压缩位率。范围在56Kbps~10Mbps之间。

12．VCAStartVideoCapture

该函数用于开始视频捕捉。

语法：

BOOL  WINAPI VCAStartVideoCapture( DWORD  dwCard,
APMODEL     enCapMode, MP4MODEL enMp4Mode,  LPCTSTR  lpFileName );

VCAStartVideoCapture语法中的参数说明如表1.9所示。

表1.9  VCAStartVideoCapture语法中的参数说明

13．VCAStopVideoCapture

该函数用于停止视频捕捉。

语法：

 BOOL  WINAPI VCAStopVideoCapture( DWORD dwCard )