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语法中的参数说明
参 数 值< xml:namespace prefix = o ns = "urn:schemas-microsoft-com:office:office" /> |
描 述 |
dwCard |
表示视频卡号 |
enCapMode |
表示视频捕捉模式 |
enMp4Mode |
表示MPEG压缩模式,只有在enCapMode 参数为CAP_MPEG4_STREAM时, 该参数才起作用 |
lpFileName |
表示视频捕捉的文件名称 |
13.VCAStopVideoCapture
该函数用于停止视频捕捉。
语法:
BOOL WINAPI VCAStopVideoCapture( DWORD dwCard ) |
dwCard:表示视频卡号。【责任编辑:
夏书 TEL:(010)68476606】