VC-摄像头控制SDK源码

#include <vfw.h>
#pragma comment(lib,"vfw32.lib")

HWND ghWndCap ; //捕获窗的句柄 
CAPDRIVERCAPS gCapDriverCaps ; //视频驱动器的能力 
CAPSTATUS gCapStatus ; //捕获窗的状态 
char szCaptureFile[] = "MYCAP.AVI";
char gachBuffer[20];

LRESULT CALLBACK WndProc(HWND,UINT,WPARAM,LPARAM);

LRESULT CALLBACK StatusCallbackProc(HWND hWnd,int nID,LPSTR lpStatusText)
{
if(!ghWndCap)return FALSE;//获得捕获窗的状态
capGetStatus(ghWndCap,&gCapStatus,sizeof(CAPSTATUS));//更新捕获窗的大小
SetWindowPos(ghWndCap,NULL,0,0,gCapStatus.uiImageWidth,gCapStatus.uiImageHeight,SWP_NOZORDER|SWP_NOMOVE);
if(nID==0){//清除旧的状态信息
SetWindowText(ghWndCap,(LPSTR)"hello");
return (LRESULT)TRUE;
}//显示状态ID和状态文本
wsprintf(gachBuffer,"Status# %d: %s",nID,lpStatusText);
SetWindowText(ghWndCap,(LPSTR)gachBuffer);
return (LRESULT)TRUE;
}
LRESULT CALLBACK ErrorCallbackProc(HWND hWnd,int nErrID,LPSTR lpErrorText)
{
if(!ghWndCap)return FALSE;
if(nErrID==0)return TRUE;//清除旧的错误
wsprintf(gachBuffer,"Error# %d",nErrID);//显示错误标识和文本
MessageBox(hWnd, lpErrorText, gachBuffer,MB_OK | MB_ICONEXCLAMATION); 
return (LRESULT) TRUE;
}

LRESULT CALLBACK FrameCallbackProc(HWND hWnd,LPVIDEOHDR lpVHdr)
{
FILE *fp;
fp=fopen("caram.dat","w");
if(!ghWndCap)return FALSE;//假设fp为一打开的.dat文件指针
fwrite(lpVHdr->lpData,1,lpVHdr->dwBufferLength,fp);
return (LRESULT)TRUE;
}


int WINAPI WinMain(HINSTANCE hInstance,HINSTANCE hPrevInstance,PSTR szCmdLine,int iCmdShow)
{
static TCHAR szAppName[]=TEXT("HelloWin");
HWND hwnd;
MSG msg;
WNDCLASS wndclass;
wndclass.style=CS_HREDRAW|CS_VREDRAW;
wndclass.lpfnWndProc=WndProc;
wndclass.cbClsExtra=0;
wndclass.cbWndExtra=0;
wndclass.hInstance=hInstance;
wndclass.hIcon=LoadIcon(NULL,IDI_APPLICATION);
wndclass.hCursor=LoadCursor(NULL,IDC_ARROW);
wndclass.hbrBackground=(HBRUSH)GetStockObject(WHITE_BRUSH);
wndclass.lpszMenuName=NULL;
wndclass.lpszClassName=szAppName;
if(!RegisterClass(&wndclass))
{
MessageBox(NULL,TEXT("This program requires WindowsNT!"),szAppName,MB_ICONERROR);
return 0;
}
hwnd=CreateWindow(szAppName,TEXT("The Hello Program"),WS_OVERLAPPEDWINDOW,CW_USEDEFAULT,CW_USEDEFAULT,CW_USEDEFAULT,CW_USEDEFAULT,NULL,NULL,hInstance,NULL);
ShowWindow(hwnd,iCmdShow);
UpdateWindow(hwnd);
while(GetMessage(&msg,NULL,0,0))
{
TranslateMessage(&msg);
DispatchMessage(&msg);
}
return msg.wParam;
}

LRESULT CALLBACK WndProc(HWND hwnd,UINT message,WPARAM wParam,LPARAM lParam)
{
HDC hdc;
PAINTSTRUCT ps;
RECT rect;
switch(message)
{
case WM_CREATE:
{
ghWndCap=capCreateCaptureWindow((LPSTR)"Capture Window",WS_CHILD|WS_VISIBLE,0,0,300,240,(HWND)hwnd,(int)0); 
capSetCallbackOnError(ghWndCap,(FARPROC)ErrorCallbackProc); 
capSetCallbackOnStatus(ghWndCap,(FARPROC)StatusCallbackProc);
capSetCallbackOnFrame(ghWndCap,(FARPROC)FrameCallbackProc);
capDriverConnect(ghWndCap,0); // 将捕获窗同驱动器连接 
//获得驱动器的能力,相关的信息放在结构变量gCapDriverCaps中
capDriverGetCaps(ghWndCap,&gCapDriverCaps,sizeof(CAPDRIVERCAPS));
capPreviewRate(ghWndCap, 66); // 设置Preview模式的显示速率 
capPreview(ghWndCap, TRUE); //启动Preview模式
if(gCapDriverCaps.fHasOverlay) //检查驱动器是否有叠加能力 
capOverlay(ghWndCap,TRUE); //启动Overlay模式
if(gCapDriverCaps.fHasDlgVideoSource)capDlgVideoSource(ghWndCap); //Video source 对话框 
if(gCapDriverCaps.fHasDlgVideoFormat)capDlgVideoFormat(ghWndCap); // Video format 对话框 
if(gCapDriverCaps.fHasDlgVideoDisplay)capDlgVideoDisplay(ghWndCap); // Video display 对话框
capFileSetCaptureFile( ghWndCap, szCaptureFile); //指定捕获文件名 
capFileAlloc(ghWndCap, (1024L * 1024L * 5)); //为捕获文件分配存储空间 
capCaptureSequence(ghWndCap); //开始捕获视频序列
capGrabFrame(ghWndCap); //捕获单帧图像

}

return 0;
case WM_PAINT:
hdc=BeginPaint(hwnd,&ps);
GetClientRect(hwnd,&rect);
DrawText(hdc,TEXT("Hello,Windows98!"),-1,&rect,DT_SINGLELINE|DT_CENTER|DT_VCENTER);
EndPaint(hwnd,&ps);
return 0;
case WM_DESTROY:
{
capSetCallbackOnStatus(ghWndCap,NULL);
capSetCallbackOnError(ghWndCap,NULL); 
capSetCallbackOnFrame(ghWndCap,NULL);
capCaptureAbort(ghWndCap);//停止捕获 
capDriverDisconnect(ghWndCap); //将捕获窗同驱动器断开 
PostQuitMessage(0);
}
return 0;
}
return DefWindowProc(hwnd,message,wParam,lParam);

///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
用VC++ 实现视频捕获编程
在桌面视频会议、可视电话等多媒体应用中,获得数字视频是一个关键的前提。
在Video for Windows(VFW) 出现之前,捕获数字视频是一项极其复杂的工作。
Microsoft 的Visual C++自从4.0版就开始支持Video for Windows(简称VFW),
这给视频捕获编程带来了很大的方便。关于多媒体应用开发,市面流行资料中介绍
较多的是MCI(媒体控制接口),而本文着重介绍的是如何使用Visual C++提供的
AVICap窗口类进行视频捕获以及其中涉及到的概念和关键问题。 
  

  一、Video for Windows简介

  VFW是Microsoft 1992年推出的关于数字视频的一个软件包,它能使应用程序数
字化并播放从传统模拟视频源得到的视频剪辑。VFW的一个关键思想是播放时不需要
专用硬件,为了解决数字视频数据量大的问题,需要对数据进行压缩。它引进了一
种叫AVI的文件标准,该标准未规定如何对视频进行捕获、压缩及播放,仅规定视频
和音频该如何存储在硬盘上,在AVI文件中交替存储视频帧和与之相匹配的音频数据。
VFW给程序员提供.VBX和AVICap窗口类的高级编程工具,使程序员能通过发送消息或
设置属性来捕获、播放和编辑视频剪辑。现在用户不必专门安装VFW了,Windows95本
身包括了Video for Windows1.1,当用户在安装Windows时,安装程序会自动地安装
配置视频所需的组件,如设备驱动程序、视频压缩程序等。

  VFW主要由以下六个模块组成:

  (1)AVICAP.DLL:包含了执行视频捕获的函数,它给AVI文件I/O和视频、音频
设备驱动程序提供一个高级接口;

  (2)MSVIDEO.DLL:用一套特殊的DrawDib函数来处理屏幕上的视频操作;

  (3)MCIAVI.DRV:此驱动程序包括对VFW的MCI命令的解释器;

  (4)AVIFILE.DLL:支持由标准多媒体I/O(mmio)函数提供的更高的命令来访问.AVI文件;

  (5)压缩管理器(ICM):管理用于视频压缩-解压缩的编解码器(CODEC);

  (6)音频压缩管理器ACM:提供与ICM相似的服务,不同的是它适于波形音频。

  Visual C++在支持VFW方面提供有vfw32.lib、 msacm32.lib 、winmm.lib等类似
的库。特别是它提供了功能强大、简单易行、类似于MCIWnd的窗口类AVICap。AVICap
为应用程序提供了一个简单的、基于消息的接口,使之能访问视频和波形音频硬件,
并能在将视频流捕获到硬盘上的过程中进行控制。

  二、AVICap编程简介

  AVICap支持实时的视频流捕获和单帧捕获并提供对视频源的控制。虽然MCI也提
供数字视频服务,比如它为显示.AVI文件的视频提供了avivideo命令集,为视频叠加
提供了overlay命令集,但这些命令主要是基于文件的操作,它不能满足实时地直接
从视频缓存中取数据的要求,对于使用没有视频叠加能力的捕获卡的PC机来说,用MCI
提供的命令集是无法捕获视频流的。而AVICap在捕获视频方面具有一定的优势,它能直
接访问视频缓冲区,不需要生成中间文件,实时性很强,效率很高。同时,它也可将数
字视频捕获到文件。

  在视频捕获之前需要创建一个捕获窗,所有的捕获操作及其设置都以它为基础。
用AVICap窗口类创建的窗口(通过capCreateCaptureWindow函数创建)被称为“捕获
窗”,其窗口风格一般为WS_CHILD和WS_VISIBLE。在概念上,捕获窗类似于标准控制
(如按钮、列表框等)。捕获窗具有下列功能:

  (1)将一视频流和音频流捕获到一个AVI文件中;

  (2)动态地同视频和音频输入器件连接或断开;

  (3)以Overlay或Preview模式对输入的视频流进行实时显示;

  (4)在捕获时可指定所用的文件名并能将捕获文件的内容拷贝到另一个文件;

  (5)设置捕获速率;

  (6)显示控制视频源、视频格式、视频压缩的对话框;

  (7)创建、保存或载入调色板;

  (8)将图像和相关的调色板拷贝到剪贴板;

  (9)将捕获的一个单帧图像保存为DIB格式的文件。

  这里需要解释一下AVICap在显示视频时提供的两种模式:

  (A)预览(Preview)模式:该模式使用CPU资源,视频帧先从捕获硬件传到
系统内存,接着采用GDI函数在捕获窗中显示。在物理上,这种模式需要通过VGA卡
在监视器上显示。

  (B)叠加(Overlay)模式:该模式使用硬件叠加进行视频显示,叠加视频的
显示不经过VGA卡,叠加视频的硬件将VGA的输出信号与其自身的输出信号合并,形
成组合信号显示在计算机的监视器上。只有部分视频捕获卡才具有视频叠加能力。

  除了利用捕获窗的九个功能外,灵活编写AVICap提供的回调函数还可满足一些
特殊需求,比如将宏capCaptureSequenceNoFile同用capSetCallbackOnVideoStream
登记的回调函数一起使用可使应用程序直接使用视频和音频数据,在视频会议的应用
程序中可利用这一点来获得视频帧,回调函数将捕获的图像传到远端的计算机。应用
程序可用捕获窗来登记回调函数(由用户编写,而由系统调用),以便在发生下列情
况时它能通知应用程序作出相应的反应:

  (1)捕获窗状态改变;

  (2)出错;

  (3)视频帧和音频缓存可以使用 ;

  (4)在捕获过程中,其它应用程序处于让步(Yield)地位。

  与普通SDK编程一样,视频捕获编程也要用到涉及视频捕获的结构、宏、消息
和函数。让编程人员感到轻松的是,发送AVICap窗口消息所能完成的功能都能调用
相应的宏来完成。例如,SendMessage(hWndCap,WM_CAP_DRIVER_CONNECT,0,0L) 
与capDriverConnect(hWndCap,0)的作用相同,都是将创建的捕获窗同视频输入
器件连接起来。

  在利用AVICap编程时,应该熟悉与视频捕获相关的结构,下面对常用的四个结
构作一简要介绍,对于前三个结构都有对应的函数来设置和获得结构包含的信息:

  (1)CAPSTATUS:定义了捕获窗口的当前状态,如图像的宽、高等;

  (2)CAPDRIVERCAPS:定义了捕获驱动器的能力,如有无视频叠加能力、有无控
制视频源、视频格式的对话框等;

  (3)CAPTUREPARMS:包含控制视频流捕获过程的参数,如捕获帧频、指定键盘
或鼠标键以终止捕获、捕获时间限制等;

  (4)VIDEOHDR:定义了视频数据块的头信息,在编写回调函数时常用到其数据
成员lpData(指向数据缓存的指针)和dwBufferLength(数据缓存的大小)。

  三、AVICap编程示例

  下面以一个简单的应用程序为例说明AVICap的使用,该程序对输入的视频流进
行实时的显示和捕获,演示需要一个视频捕获卡和摄像头。界面中的菜单项如图1所
示。其中,菜单项Display可以以Preview 或Overlay模式显示图像;菜单项Setting可
通过弹出AVICap提供的对话框Video Source、Video Format和Video Display来对捕获
进行设置,图4 中的图像就是按照图2、图3的对话框所示进行设置、以Preview模式显
示的结果;菜单项Capture可将视频流或单帧图像捕获到指定的文件中去。

  图1 菜单项

  图2 Video Format对话框

  图3 Video Source对话框

  图4 图2和图3设置下显示的一帧图

  由于篇幅有限,下面仅介绍与视频捕获相关的编程。

  1、定义全局变量:

  HWND ghWndCap ; //捕获窗的句柄

  CAPDRIVERCAPS gCapDriverCaps ; //视频驱动器的能力

  CAPSTATUS gCapStatus ; //捕获窗的状态

  2、处理WM_CREATE消息:

  //创建捕获窗,其中hWnd为主窗口句柄

  ghWndCap = capCreateCaptureWindow((LPSTR)"Capture Window",WS_CHILD | WS_VISIBLE, 0, 0, 300,240, (HWND) hWnd, (int) 0);

  //登记三个回调函数,它们应被提前申明

  capSetCallbackOnError(ghWndCap, (FARPROC)ErrorCallbackProc); capSetCallbackOnStatus(ghWndCap, (FARPROC)StatusCallbackProc); capSetCallbackOnFrame(ghWndCap, (FARPROC)FrameCallbackProc);

  capDriverConnect(ghWndCap,0); // 将捕获窗同驱动器连接

  //获得驱动器的能力,相关的信息放在结构变量gCapDriverCaps中

  capDriverGetCaps(ghWndCap,&gCapDriverCaps,sizeof(CAPDRIVERCAPS)) ;

  3、处理WM_CLOSE消息:

  //取消所登记的三个回调函数

  capSetCallbackOnStatus(ghWndCap, NULL);

  capSetCallbackOnError(ghWndCap, NULL);

  capSetCallbackOnFrame(ghWndCap, NULL);

  capCaptureAbort(ghWndCap);//停止捕获

  capDriverDisconnect(ghWndCap); //将捕获窗同驱动器断开

  4、处理菜单项Preview:

  capPreviewRate(ghWndCap, 66); // 设置Preview模式的显示速率

  capPreview(ghWndCap, TRUE); //启动Preview模式

  5、处理菜单项Overlay:

  if(gCapDriverCaps.fHasOverlay) //检查驱动器是否有叠加能力

  capOverlay(ghWndCap,TRUE); //启动Overlay模式

  6、处理菜单项Exit:

  SendMessage(hWnd,WM_CLOSE,wParam,lParam);

  7、分别处理Setting下的三个菜单项,它们可分别控制视频源、视频格式及显示:

  if (gCapDriverCaps.fHasDlgVideoSource)

  capDlgVideoSource(ghWndCap); //Video source 对话框

  if (gapDriverCaps.fHasDlgVideoFormat)

  capDlgVideoFormat(ghWndCap); // Video format 对话框

  if (CapDriverCaps.fHasDlgVideoDisplay)

  capDlgVideoDisplay(ghWndCap); // Video display 对话框

  8、处理Video Stream菜单项,它捕获视频流到一个.AVI文件:

  char szCaptureFile[] = "MYCAP.AVI";

  capFileSetCaptureFile( ghWndCap, szCaptureFile); //指定捕获文件名

  capFileAlloc( ghWndCap, (1024L * 1024L * 5)); //为捕获文件分配存储空间

  capCaptureSequence(ghWndCap); //开始捕获视频序列

  9、处理Single Frame菜单项:

  capGrabFrame(ghWndCap); //捕获单帧图像

  10、定义三个回调函数:

  LRESULT CALLBACK StatusCallbackProc(HWND hWnd, int nID, LPSTR lpStatusText)

  {

  if (!ghWndCap) return FALSE;

  //获得捕获窗的状态

  capGetStatus(ghWndCap, &gCapStatus, sizeof (CAPSTATUS));

  //更新捕获窗的大小

  SetWindowPos(ghWndCap, NULL, 0, 0, gCapStatus.uiImageWidth,

  gCapStatus.uiImageHeight, SWP_NOZORDER | SWP_NOMOVE);

  if (nID == 0) { // 清除旧的状态信息

  SetWindowText(ghWndCap, (LPSTR) gachAppName);

  return (LRESULT) TRUE;

  }

  // 显示状态 ID 和状态文本

  wsprintf(gachBuffer, "Status# %d: %s", nID, lpStatusText);

  SetWindowText(ghWndCap, (LPSTR)gachBuffer);

  return (LRESULT) TRUE;

  }

  LRESULT CALLBACK ErrorCallbackProc(HWND hWnd, int nErrID,LPSTR lpErrorText)

  {

  if (!ghWndCap)

  return FALSE;

  if (nErrID == 0)

  return TRUE;// 清除旧的错误

  wsprintf(gachBuffer, "Error# %d", nErrID); //显示错误标识和文本

  MessageBox(hWnd, lpErrorText, gachBuffer,MB_OK | MB_ICONEXCLAMATION);

  return (LRESULT) TRUE;

  }

  LRESULT CALLBACK FrameCallbackProc(HWND hWnd, LPVIDEOHDR lpVHdr)

  {

  if (!ghWndCap)

  return FALSE;

  //假设fp为一打开的.dat文件指针

  fwrite(fp,lpVHdr->lpData,lpVHdr->dwBufferLength,1);

  return (LRESULT) TRUE ;

  }

  值得注意的是:应在.cpp文件中加入#include 一句,在Link设置中加入vfw32.lib。

  上述的回调函数FrameCallbackProc是将视频数据直接从缓冲写入文件,也可利
用memcpy函数将视频数据直接拷贝到另一缓存。同理,可定义VideoStreamCallbackProc。
capSetCallbackOnVideoStream的使用比capSetCallbackOnFrame稍微复杂一些。在捕获过
程中,当一个新的视频缓冲可得时,系统就调用它所登记的回调函数。在缺省情况下,捕
获窗在捕获过程中不允许其它应用程序继续运行。为了取消这个限制,可以设置CAPTUREPARMS
的成员fYield为TRUE或建立一个Yield回调函数。为了解决潜在的重入(reentry)问题,可
在YieldCallbackProc中用PeekMessage过滤掉一些消息,例如鼠标消息。

  四、结束语

  Visual C++提供的AVICap窗口类为捕获数字视频流及其相关操作提供了很大的方便,
灵活编写其中的回调函数可满足实时视频传输的需要,例如应用程序可直接从缓冲中取得
数字视频并对其进行压缩编码后实时地传到远端的计算机。笔者所从事的电话网上的可视
电话系统就是采用AVICap进行视频捕获的,这种方法同样可用于其它多媒体会议系统中,
如ISDN、局域网上的会议系统等。
////////////////////////////////////////////////////////////////////

Microsoft® Video for Windows® (VFW) 提供的函数可以让应用程序去处理视频数据。 VFW 在16位Windows的时候就被引入了。它的许多重要功能已经被DirectX取代了。 要获得更多的信息,你可以参考DirectX 的文档。
下面讲介绍VFW的视频捕获:
3.视频捕获
你可以使用windows的AVICap 类轻松地完成视频捕获。AVICap 提供给应用程序一个简单的、基于消息的接口去访问视频设备和录音设备,并且可以控制处理视频流捕获。
AVICap支持实是视频流捕获和实时单帧图像捕获。另外,AVICap 提供了对视频源的控制(MCI媒体控制接口设备),因此使用者可以通过应用程序控制一个视频源开始和结束的位置,并且可以加大对帧捕获的控制。
你使用AVICap 类可以完成如下的任务:
 
l         捕获声音和视频,并将他们写入到一个AVI文件中。
l         动态连接和断开视频和音频的输入设备。
l         使用覆盖或预览的方法去显示当前的视频信号。
l         指定一个文件用于捕获,并且把这个捕获文件的内容拷贝给另一个文件。
l         设定捕获图像速度(好多帧)。
l         显示对话框用于控制视频源和格式。
l         创建、保存、加载调色板。
l         拷贝图像和调色板到剪贴板中。
l         捕获并把图像作为一个DIB位图保存。
 
 
视频捕获将数字化一个视频流和音频数据,并且将他们保存在硬盘和其他存储设备上。
这里将描述如何在应用程序中简单地应用视频捕获,它通过三句代码实现。它还介绍了如何通过发送消息给视频捕获窗口来结束或中断一个视频会话。
AVICap 捕获窗口可以把捕获的音视频信息写入一个AVI文件中。你的应用程序可以自由地处理这个AVI文件、管理缓存区的音视频数据、还可以在底层访问音视频设备的驱动器。AVICap为应用程序提供了一个灵活的接口。你可以使用下面的代码,在你的应用程序中加入视频捕获:
 
HWndC  =  capCreateCaptureWindow ( "My Own Capture Window",
            WS_CHILD | WS_VISIBLE  ,  0 ,  0,  160,  120,  hwndParent,  nID);
SendMessage  ( hWndC,  WM_CAP_DRIVER_CONNECT,  0/* wIndex */,  0L);
SendMessage  ( hWndC,  WM_CAP_SEQUENCE,  0,  0L);
 
宏接口同样有用,你可以选择是使用宏接口还是SendMessage 函数来实现上面的功能,不过宏接口可以让你的代码更加容易理解。下面就使用了宏接口。
 
HWndC  =  capCreateCaptureWindow (" My Own Capture Window ",
    WS_CHILD | WS_VISIBLE ,  0,  0,  160,  120,  hwndParent,  nID);
capDriverConnect  ( hWndC,  0);    // 宏接口
capCaptureSequence  ( hWndC);     // 宏接口
 
你的应用程序创建AVICap捕获窗口,并和视频设备建立连接后。你创建的这个捕获窗口就准备捕获数据了。这时,你可以通过发送WM_CAP_SEQUENCE消息(或capCaptureSequence 宏)开始对数据进行捕获。
 
WM_CAP_SEQUENCE将使用默认设置,开始对视频和音频进行捕获,并把数据放在一个CAPTURE.AVI的文件中,捕获动作将一直持续,除非有下面的事件发生:
l         用户按了ESC键或者鼠标的按钮。
l         你的应用程序停止或者退出了捕获操作。
l         磁盘写满了。
 
在应用程序中,你可以通过发送WM_CAP_STOP命令(或capCaptureStop)给捕获窗口,让它停止向文件写数据。你还可以通过发送WM_CAP_ABORT命令(或capCaptureAbort)给捕获窗口,让它中断捕获操作。
 
 
 
通过对定义在CAPTUREPARMS结构中的捕获参数进行修改,你可以完成:
l         改变捕获的帧频律(帧/秒);
l         指定用键盘或鼠标去结束一个捕获会话;
l         为一个捕获会话指定时间周期;
 
捕获的帧频率
 
捕获的帧频率表示在一个捕获会话中,每秒要捕获多少帧。你通过WM_CAP_GET_SEQUENCE_SETUP 消息(capCaptureGetSetup宏)可以得到当前捕获的帧频率。当前的帧频率被保存在CAPTUREPARMS结构的dwRequestMicroSecPerFrame 成员中。你可以对该值进行修改,从而去改变帧频率。该值为捕获一帧要用的时间(单位是微秒 1/1000000秒),修改后,你可以发送WM_CAP_SET_SEQUENCE_SETUP消息(或capCaptureSetSetup宏)给你的捕获窗体,来刷新CAPTUREPARMS 结构。dwRequestMicroSecPerFrame 默认值是66667微秒,表示每秒15帧。(1000000/15=66667)
 
退出数据捕获
 
你可以让用户按这几种方法退出一个捕获会话,按键盘上的一个键或几个组合键、或者按鼠标的左键或者是右键。如果用户退出一个实时的捕获会话,那么捕获文件中的内容将被系统丢弃掉。如果用户退出一个步帧(step-frame)捕获的会话,捕获文件将保存到退出时刻前的所有数据。
       你可以通过发WM_CAP_GET_SEQUENCE_SETUP消息(或capCaptureGetSetup宏)给捕获窗口,来获得捕获退出的设置信息。当前的退出按钮设置保存在CAPTUREPARMS结构的vKeyAbort 成员中,当前的退出鼠标设置保存在fAbortLeftMousefAbortRightMouse成员中。你可以改变这几个成员,实现对当前值的修改。当你修改完成后,你可以发送WM_CAP_SET_SEQUENCE_SETUP消息(或capCaptureSetSetup宏)给你的捕获窗体,来刷新CAPTUREPARMS 结构。
vKeyAbort 默认值是 VK_ESCAPE。在重新指定其他按键前,你必须调用RegisterHotKey 函数。fAbortLeftMouse 和fAbortRightMouse 是TRUE。
 
时间限定
 
通过使用CAPTUREPARMS结构的fLimitEnabled 和wTimeLimit成员,你可以去限定一个捕获操作的时间周期。fLimitEnabled 表示是否要对捕获操作限定时间, wTimeLimit 用于指定限定时间的最大值。
    你发WM_CAP_GET_SEQUENCE_SETUP消息(capCaptureGetSetup宏)给捕获窗口,就可以得到fLimitEnabled 和wTimeLimit的值。 FLimitEnabled为TRUE表示要指定时间周期。WTimeLimit单位为秒。修改完成后,你可以发送WM_CAP_SET_SEQUENCE_SETUP消息(或capCaptureSetSetup宏)给你的捕获窗体,来刷新CAPTUREPARMS 结构。
fLimitEnabled 默认值为FALSE.
 
 
 
捕获窗体类似于一个标准控件(不如按钮、列表框…),它一般使用WS_CHILD 和 WS_VISIBLE窗口类型。.
 
创建一个AVICap捕获窗口
       使用capCreateCaptureWindow 函数可以创建一个AVICap的捕获窗口。这个函数返回一个窗口句柄,这个句柄就是捕获窗口的句柄,后面其他操作就是通过发送消息给该句柄来实现。你可以在一个程序中创建多个捕获窗口,并且每个窗口连接到不同的捕获设备上。
 
建立捕获窗口到捕获设备的连接
你可以动态地连接或断开捕获窗口与设备间的链接。通过使用WM_CAP_DRIVR_CONNECT消息(或capDriverConnect宏),可以实现捕获窗体与设备驱动间的连接。当捕获窗体和捕获设备驱动连接后,你就可以发送针对设备的消息给该窗体了。
如果你的系统安装了多个捕获设备,你可以通过在发送WM_CAP_DRIVER_CONNECT消息时,设置wPrarm参数(integer)。来指定捕获窗口与那个具体的视频捕获设备相连接。
WPrarm参数是一个整数,它表示一个系统已经安装的视频捕获设备列表的索引(注册表中或这System.ini [drivers]中的信息)。该列表的索引从0开始。
       通过capGetDriverDescription函数可以获得安装的捕获驱动程序的名称和版本。你的应用程序可以使用这个函数列举除安装的所有捕获设备,让用户可以选择其中一个去与捕获窗口相联。
通过发送WM_CAP_DRIVER_GET_NAME消息(capDriverGetName宏),可以获得与指定窗体连接的捕获设备的名称。通过发送WM_CAP_DRIVER_GET_VERSION消息(capDriverGetVersion宏),可以获得与指定窗体连接的捕获设备的版本。
通过发送WM_CAP_DRIVER_DISCONNECT消息(capDriverGetDisconnect宏),可以断开连接。当捕获窗体销毁后,任何连接的视频捕获设备都将自动断开。
 
父子窗体交付
       一些系统级的消息,比如 WM_PALETTECHANGED、WM_QUERYNEWPALETTE,只被发送到顶层(top-level)和overlapped窗口。如果一个捕获窗体是一个资窗体,那它的父窗口应该来转寄这些消息。
       同样地,假如父窗口尺寸改变了,它可能需要发送一个通知消息给捕获窗口。相反,如果捕获视频尺寸变化了,捕获窗口可能需要发一个通知消息给父窗口。最简单的管理方法是让捕获窗口的尺寸等于捕获视频流的尺寸,随时把改变的尺寸告诉给父窗口。
 
捕获窗体状态
 
通过发送WM_CAP_GET_STATUS消息(capGetStatus宏),可以获得当前捕获窗口的状态。这个消息得到一个CAPSTATUS结构体的拷贝,状态信息就在这个结构体的成员中。
CAPSTATUS 结构体包含了图形尺寸大小、滚动位置(scroll position)、是否覆盖(overlay)或者预览(preview)等信息。因为在CAPSTATUS 中的信息是动态的,你的应用程序应该随时去刷新这个结构体中的内容。
改变捕获窗口的尺寸对实际的视频流的尺寸没有影响。
      
视频捕获可以做这几个方面的工作:访问 视频源、显示选项、格式和压缩选项。音频捕获包括指定音频格式和选择压缩方式。
 
捕获驱动性能
 
通过发送WM_CAP_DRIVER_GET_CAPS消息(capDriverGetCaps宏),可以获得当前连接的捕获设备的性能。发送该消息后,会返回一个CAPDRIVERCAPS结构的对象。设备的性能信息,就在这个对象中。
 
 
视频对话框(Video Dialog Boxes
      
每个捕获设备的驱动程序都可以为控制视频信号和捕获处理和视频压缩提供4个对话框。这些对话框中的内容都是视频捕获驱动程序定义的。
      
视频源对话框(Video Source dialog box)用于选择视频输入通道和视频图像的动态参数。 它可以列举出当前连接视频设备的信号类型(SVHS和复合类型),并且可以通过该对话框去修改图像的色调、亮度、饱和度。你可以通过使用WM_CAP_DLG_VIDEOSOURCE 消息 (或 capDlgVideoSource 宏)来显示和刷新这个窗口。
 
视频格式对话框(Video Format dialog box)用于选择数字视频的框架大小和视频图像的色深,以及捕获视频图像的压缩格式。你可以通过使用WM_CAP_DLG_VIDEOFORMAT消息 (或 capDlgVideoFormat宏)来显示和刷新这个窗口。
 
视频显示对话框(Video Display dialog box)用于控制视频外观。在该对话框上进行了修改只是对视频显示起作用,对于实际的视频数据是不会造成改变的。比如,可以改变显示的颜色,饱和度等等....。你可以通过使用WM_CAP_DLG_VIDEODISPLAY消息 (或 capDlgVideoDisplay宏)来显示和刷新这个窗口。
 
视频压缩对话框(Video Compression dialog box)用于设置视频压缩的格式。通过使用WM_CAP_DLG_VIDEOCOMPRESSION消息 (或 capDlgVideoCompression宏)来显示和刷新这个窗口。
 
预览和覆盖模式 (Preview and Overlay )
      
一般,一个捕获驱动提供两种方式来观看输入的视频流:预览模式和覆盖模式。如果捕获驱动可以提供上面两种模式,那么用户就可以选择其中的模式来使用。
 
预览模式从捕获设备硬件传输数据帧到系统的内存中,并且在捕获窗口中使用GDI函数来显示这些数据帧。当捕获窗口的父窗体失去焦点的时候,在应用程序的视频预览的数据将变慢,如果父窗体获的焦点后,将对预览显示进行加速。因为预览处理的这种处理方式将大大提高整个系统的效率。
这里用3个消息用于控制预览操作。
l         WM_CAP_SET_PREVIEW消息(capPreview宏)可以打开或者关闭预览模式。
l         WM_CAP_SET_PREVIEWRATE 消息(capPreviewRate宏)可以设置预览模式下图像的帧速度。
l         WM_CAP_SET_SCALE 消息 (capPreviewScale 宏) 打开或者关闭预览视频的缩放比例。
当预览和缩放比例属性都打开后,那么视频将被缩放到和捕获窗口尺寸一样大。打开预览模式后,系统将自动关闭覆盖模式。
 
覆盖模式,将不占用CPU的处理资源,直接在显示器上显示视频内容。所用的处理是有捕获设备硬件来完成。发送WM_CAP_SET_OVERLAY消息(或capOverlay宏)给捕获窗口,可以打开覆盖模式。打开覆盖模式后,将自动关闭预览格式。
 
无论是预览模式还是覆盖模式,都可以通过发送WM_CAP_SETSCROLL消息(capSetScroollPos宏),可以设置图像的在整个视频帧的滚动位置(scroll position)。
 
 
视频格式
 
       通过发送WM_CAP_GET_VIDEOFORMAT消息(capGetVideoFormat宏)给视频捕获窗口可以得到一个结构,在这个结构体中就包含了视频的格式、大小。
       通过发送WM_CAP_SET_VIDEOFORMAT消息(capSetVideoFormat宏)给视频捕获窗口可以对视频格式进行修改设置。
You can set the format of captured video data by sending the WM_CAP_SET_VIDEOFORMAT message (or thecapSetVideoFormat macro) to a capture window.
 
视频捕获设置
 
CAPTUREPARMS 数据结构包括了视频流的控制参数。它允许完成如下的任务:
l         指定帧速度(Frame rate)。
l         指定为视频分配的缓存大小。
l         关闭或者打开音频捕获。
l         设定捕获的时间间隔。
l         指定捕获设备(MCI设备、VCR或者影碟)。
l         指定键盘或鼠标去控制结束捕获。
l         指定适用的视频类型
 
通过发送WM_CAP_GET_SEQENCE_SETUP消息(capCaptureGetSetup)给捕获窗体,可以获得一个CAPTUREPARMS数据结构的对象,当前视频捕获的设置信息就在这里面。
 
你可以改写CAPTUREPARMS对象的成员,来实现对视频捕获信息的修改。修改后,发送WM_CAP_SET_SEQUENCE_SETUP消息(capCaptureSetSetup)给捕获窗体,并把这个CAPTUREPARMS 对象发给捕获窗体,就可以实现修改。
 
音频格式
 
通过发送WM_CAP_GET_AUDIOFORMAT消息(capGetAudioFormat 和capGetAudioFormatSize宏)给捕获窗体,你就可以获得当前的音频数据格式或音频数据结构的大小。默认音频捕获格式是 mono, 8-bit, 11 kHz PCM。
当你使用WM_CAP_GET_AUDIOFORMAT消息得到音频格式后,通常会使用WAVEFORMATEX这个数据结构。
通过发送WM_CAP_SET_AUDIOFORMAT消息(capSetAudioFormat宏)给捕获窗体,你可以设置音频数据捕获格式。当设置这个音频格式时,你可以通过一个指针指向一个WAVEFORMAT ,WAVEFORMATEX,或者PCMWAVEFORMAT数据结构。
 
3.1.5捕获文件和缓存区
 
捕获文件名
 
AVICap默认,把音视频数据从捕获窗口保存到当前驱动得根目录下,文件名称为CAPTURE.AVI。发送WM_CAP_FILE_SET_CAPTURE_FILE消息(capFileSetCaptureFile)给捕获窗体,可以改变保存的文件名。这个消息指定文件名;它不实际创建文件,分配空间,也不能打开文件。通过发送WM_CAP_FILE_GET_CAPTURE_FILE消息(capFileFGetCaptureFile宏)给捕获窗口,就可以得到当前文件名。
 
保存捕获数据到一个新文件
 
如果用户想保存捕获数据,把数据存到另外一个文件中。可以使用WM_CAP_FILE_SAVEAS消息(capFileSaveAs宏) 。这个消息不能改变捕获文件的名称和内容。你必须去指定新建的文件名,因为捕获文件将保留原来的文件名称。
 
为捕获文件预分配磁盘空间
 
在捕获操作前,先在磁盘上为捕获文件建一个指定大小的文件。预分配空间将减少数据保存时的处理时间。可以通过WM_CAP_FILE_ALLOCATE消息(capFileAlloc宏)来预分配一个捕获文件。
你要预分配足够大的磁盘空间去保存预计最大的捕获文件。预分配磁盘空间没有限定捕获文件的大小。如果捕获的数据大于了分配的空间,文件尺寸将自动变大。对一个捕获文件进行重写数据,将对文件的已经分配的磁盘空间进行重写。
通过对捕获文件进行磁盘碎片整理可以提高捕获性能。要对文件进行碎片整理,可以使用一个碎片整理工具来完成,比如Disk Defragmenter。
通过使用没压缩的磁盘来保存数据,同样可以提高性能。因为在捕获期间压缩数据将对磁盘的吞吐量进行限制。
 
索引大小
 
       在每个AVI文件中都会使用一个指定大小的索引去查找音视频数据块。在一个索引的入口定位了一个视频帧或者一个波形声音的缓存器。所以,这个索引的大小简接地限定了一个捕获文件所能保存的帧的数量上限。
通过发送WM_CAP_GET_SEQUENCE_SETUP消息(capCaptureGetSetup宏)给捕获窗口就可以得到当前的索引大小。这个索引大小就保存在CAPTUREPARMS数据结构对象的一个成员中(dwIndexSize)。你可以在dwIndexSize中指定一个新的索引大小,并通过发送消息WM_CAP_SET_SEQUENCE_SETUP(capCaptureSetSetup宏)给捕获窗口完成信息设置。索引默认大小34,952 (允许32K 帧和想匹配的声音缓存器).
音视频块的间隔尺寸(Granularity)
 
数据块的间隔尺寸是一个AVI文件的逻辑块大小。它用于写和读音视频数据块。当向磁盘写音视频数据时, AVICap 将在每个数据块中加入一个必须的填充块(filler chunks (RIFF "JUNK" chunks)) 去填充满该数据块。
你可以使用WM_CAP_GET_SEQUENC_SETUP消息(capCaptureGetSetup)去获得当前的块间隔尺寸(Granularity)。CAPTUREPARMSwChunkGranularity 成员保存的是当前的块间隔尺寸信息。通过对该成员的改写,并发送WM_CAP_GET_SEQUENC_SETUP消息(capCaptureSetSetup),可以对其进行修改。你设置该参数为零的话,那么块间隔尺寸的值就为磁盘的扇区大小。
 
视频缓存区
 
这个缓存区将视频数据放在内存的堆中。缓存区的大小可以改变,并且它的大小是由CAPTUREPARMSwNumVideoRequested 成员和系统可以的内存大小来决定。
你可以使用WM_CAP_GET_SEQUENC_SETUP消息(capCaptureGetSetup)去获得当前的视频缓存区的大小。CAPTUREPARMSwNumVideoRequested 成员保存的是当前的缓存区尺寸。通过对该成员的改写,并发送WM_CAP_GET_SEQUENC_SETUP消息(capCaptureSetSetup),可以对其进行修改。
 
音频缓存区
 
你可以使用下面三种方法来控制捕获的音频数据:
 
l         在捕获中包含音频或者不包含音频
l         按要求指定音频缓存区的大小
l         Request that audio buffers be a specific size.
 
你可以使用WM_CAP_GET_SEQUENC_SETUP消息(capCaptureGetSetup)去获得当前的音频缓存区的设置。CAPTUREPARMSfCaptureAudio指定在这次捕获操作中是否包括对声音的捕获。WNumAudioRequested保存当前要求的音频缓存区的大小。dwAudioBufferSize 保存当前的音频缓存区的大小。
通过对该成员的改写,并发送WM_CAP_GET_SEQUENC_SETUP消息(capCaptureSetSetup),可以对其进行修改。
fCaptureAudio 默认值是TRUE。The default buffer size (the value of) can contain 0.5 seconds of audio data or 10K, whichever is greater.
 
3.1.6捕获变化
      
除了对基于持续时间间隔的流捕获外,AVICap还支持如下的捕获:
l         手控制帧捕获
l         Still-image 捕获
l         不使用磁盘存储的捕获
l         从一个MCI设备的流捕获(real-time and step-frame)
 
手动帧捕获
 
如果你向指定捕获视频流中个别帧,你可以通过WM_CAP_SINGLE_FRAME_OPEN消息、WM_CAP_SINGLE_FRAME消息、WM_CAP_SINGLE_FRMAE_CLOSE消息来控制帧序列(capCaptureSingleFrameOpen、/capCaptureSingleFramecapCaptureSigleFrameClose)。
 
典型应用是,这些消息用于向捕获文件添加单独的帧来创建一个动画, WM_CAP_SINGLE_FRAME_OPEN 为手动捕获操作打开一个文件,WM_CAP_SINGLE_FRAME用于捕获一个单独的帧放在文件中。
WM_CAP_SINGLE_FRMAE_CLOSE用于关闭这个捕获文件。
 
注:  该操作支持音视频同时捕获。
Still-Image捕获
 
如果要捕获一个单独的帧作为一个静态图像,你可以使用WM_CAP_GRAB_FRAME_NOSTOP或者 WM_CAP_GRAB_FRAME 消息 (capGrabFrameNoStop
一旦开始捕获,你可以拷贝图像给其他应用程序。你可以从帧缓存区拷贝一个图像到剪贴板(使用WM_CAP_EDIT_COPY 消息或capEditCopy宏)。你还可以使用如下的消息,将缓存区的一张图像拷贝到一个DIB位图中(WM_CAP_FILE_SAVEDIB消息或capFileSaveDIB宏)。
 
不使用磁盘存储的捕获
     
使用WM_CAP_SEUENCE_NOFILE消息(capCaptureSequenceNoFile宏),可以不向磁盘文件写入数据。该消息仅在配合回调函数时有用,它允许你的应用程序直接使用音视频数据。例如,在视频会议中,应用程序使用该消息区获得视频流。回调函数将传输捕获的图像传送给远程的计算机。
 
MCI设备进行流捕获
MCI设备加强了实时捕获和步进帧(step-frame)捕获的处理操作。你可以指定一个MCI设备,比如一张影碟或者一盘录像带(VCR)来充当视频源。通过发送消息并指定你要选定的MCI设备的名称。消息:WM_CAP_SET_MCI_DEVICE (capSetMCIDeviceName宏)。获得当前使用的设备可以使用WM_CAP_GET_MCI_DEVICEcapGetMCIDeviceName)消息。
在实时捕获中, the capture window synchronizes the capture operation and compensates for delays associated with positioning the MCI video source and initializing the resources (such as capture buffers) required for capturing data. The capture window expects a valid MCI video device to be installed in the system for capturing data this way.
控制MCI设备的规格信息保存在CAPTRUEPARMS数据结构体的数据成员中。MCI兼容的视频源包括录像机(VCR)和光碟。如果fMCIControl数据成员为TRUE,捕获窗口采用MCI操作。捕获窗口使用dwMCIStartTimedwMCIStopTime来获得开始和结束位置(毫秒)。 如果fMCIControl数据成员的值为FALSE, dwMCIStartTimedwMCIStopTime的值将被忽略不见。
你可以使用Media Player 去快速检查MCI设备是否正确地连接到了你的系统上,如果在视频显示显示了图像,就表示这个视频源正确连接到了捕获硬件上。
在步进帧(step-frame)捕获情况下, the capture window synchronizes the capture operation and compensates for the delays associated with positioning the MCI video source and initializing the resources required for capturing data. In addition, the capture window ensures that no frames are dropped; it steps through the video frames individually, ensuring that the frame is captured and stored before capturing the next frame in the video stream.
步进帧(step-frame)捕获控制的规格信息保存在CAPTRUEPARMS数据结构体的数据成员中。步进帧(step-frame)捕获除了使用视频捕获要用的数据成员外,还使用其他的数据成员:fStepMCIDevicefStepCaptureAt2x, 和 wStepCaptureAverageFrames。如果数据成员fStepMCIDevice的值为TRUE,捕获窗口采用步进帧(step-frame)捕获。捕获窗口将使用这两个参数来指定捕获的开始和结束位置(dwMCIStartTimedwMCIStopTime 毫秒)。捕获窗口使用fStepCaptureAt2x 来决定捕获硬件捕获的视频帧使用两个普通的分辨率。使用 wStepCaptureAverageFrames 来指定捕获时每帧图像使用的时间大小。
       如果在一个步进帧(step-frame)捕获中,指定fStepCaptureAt2x为TRUE,那么捕获硬件将使用两个指定的解析度来进行捕获(高和宽的解析度都是双倍的)。它使用软件,在指定的解析度的基础上改写图像的象素,让其成为更高解析度的图像。如果硬件不支持基于硬件的批量处理,你也可以使用该选项。并且捕获为RGB格式。
 
注意:  如果你的硬件步支持基于硬件的批量处理(hardware-based decimation), it can capture samples at a higher rate than specified and use these additional samples to obtain color definitions that are more consistent with the original image. The additional samples are discarded after they are used, and the hardware passes samples to the capture driver at the specified rate。
 
如果指定了步进帧捕获, wStepCaptureAverageFrames 成员用于指定捕获一帧图像要使用的时间,它是一个采样的标准时间。以后捕获图像捕获平均时间都会基于这个时间。采用这种机制,降会减少在一个图像帧的随机数字化噪音。这个数据成员的标准值是5。
关于MCI的信息可以查看MSDN上的信息。
  
3.1.7高级捕获选项
 
这节描述在一个捕获操作中,你还可以进行的其他选择。
l         测量视频质量
l         用户初始化捕获
l         和调色板一起工作
l         在AVI文件中的嵌入信息块
l         用户数据消息(Messages)
 
测量视频质量
测量视频质量的一个方法是去限定在一个捕获操作期间丢掉的捕获图像帧的数字。当流捕获完成后,质量 = 丢掉的帧 / 所有的帧。如果这个数(百分数)大于wPercentDropForError的值,AVICap将发一个错误信息给错误回调函数。WPercentDropForErrorCAPTUREPARMS数据结构体的一个数据成员。
通过WM_CAP_GET_SEQUENCE_SETUP消息(capCaptureGetSetup宏)可以得到当前设定的丢掉帧的限定值。同样对wPercentDropForError进行修改,再把修改后的数据结构体发送给捕获窗体就可以完成对限定值的修改。WM_CAP_GET_SEQUENCE_SETUP消息(capCaptureSetSetup), wPercentDropForErrorm默认值10 (10%)。
 
用户初始化捕获
    通过WM_CAP_GET_SEQUENCE_SETUP消息(capCaptureGetSetup宏)可以得到当前用户初始化捕获的状态值。该值存放在fMakeUserHitOKToCapture中。在开始一个捕获会话前,设置该值为TRUE,可以为用户提供精确的控制。系统为所有的音视频分配好数据缓存区后,AVICap会显示一个对话框。它让用户清除因为软件初始化导致的捕获延迟。如果你的应用程序为视频数据分配的数据缓存区很小,那么这个对话框可能就没的必要了。该值的默认值是FALSE。
 
和调色板一起工作
       最初,如果视频捕获格式需要一个调色板,那么捕获窗口将使用捕获驱动提供的调色板来代替。这个调色板可能由灰度值,或者可选的彩色值组成。使用WM_CAP_PAL_PASTE或者WM_CAP_PAL_OPEN消息(capPalettePastecapPaletteOpen)可以获得一个现存的调色板去替换默认的调色板。你还可以创建一个自定义的调色板去替换默认的调色板,你要使用WM_CAP_PAL_AUTOCREATE 或者 WM_CAP_PAL_MANUALCREATE消息 ( capPaletteAuto 或 capPaletteManual )。当你替换了调色板后,捕获窗体和驱动程序将使用替换后的调色板,直到你创建或打开其他的调色板为止。
 
WM_CAP_PAL_AUTOCREATE 或者 WM_CAP_PAL_MANUALCREATE 消息将创建一个基于当前视频输入最优化的调色板。这个自定义的调色板将为视频提供一个最好的颜色逼真度,因为这个调色板的颜色是基于这个视频的。捕获窗口创建一个采样颜色的3维柱状图。它会减小真实颜色和渐近色间的值。
 
在发送WM_CAP_PAL_AUTOCREATE消息时, 你必须指定AVICap采样的帧数以及调色板的颜色尺寸。在指定帧数时,要保证帧数足够大以保证所有的视频颜色可以被采样收集到。
    使用WM_CAP_PAL_MANUALCREATE消息可以对当前帧进行采样。通过该消息,进行几次手动选择帧采样操作,你可以创建自己的调色板,它包含了你想要的颜色信息。
 
一个调色板可以包含256种颜色。如果你要合并调色板,或者在视频队列中同时在显示其他视频或图像。你可以去使用一个小的颜色集合,这样不同图像或视频的颜色就可以共存了。
使用WM_CAP_PAL_SAVE消息(capPaletteSave),可以保促一个新的调色板。通过WM_CAP_PAL_OPEN消息还可以得到当前的调色板。你可以在调色板处理前保存一个调色板,或者为其他应用程序使用去保存一个调色板。
 
使用WM_CAP_PAL_PASTE可以把剪贴板中的调色板粘贴到捕获窗口中。捕获窗口通过这个调色板到捕获驱动。其他程序可以拷贝调色板到剪贴板中。你也可以把调色板粘贴到剪贴板中。使用WM_CAP_ENDIT_COPY消息(capEditCopy)。它将拷贝视频缓存区(包括调色板)到剪贴区。
AVI文件中的嵌入信息块
你可以在一个AVI文件中插入信息块,比如文本或者自定义的数据。通过使用下面的消息:WM_CAP_FILE_SET_INFOCHUNK(capFileSetInfoChunk)。可以使用这个消息还可以清除掉一个AVI文件中的信息块。
 
用户数据消息
       通过使用WM_CAP_GET_USER_DATA和WM_CAP_SET_USER_DATA消息可以关联数据到一个捕获窗体。(capGetUserData和 capSetUserData宏)。使用…Get…消息可以得到一个LONG数据值,可以通过_Set_消息去设置该值。
 
 
3.1.8 AVICap回调函数
       你的应用程序可以为一个捕获窗口注册一些回调函数,它们可以告诉你的应用程序一些变化。比如捕获状态发生变化了,或者有错误发生了,音视频缓存区可使用了。下面的消息设置回调函数。

消           息
说           明
WM_CAP_SET_CALLBACK_CAPCONTROL
CapSetCallbackOnCapControl 宏
在应用程序中指定回调函数用于控制捕获的开始和结束。
WM_CAP_SET_CALLBACK_ERROR
CapSetCallbackOnError宏
在应用程序中指定回调函数,当出错的时候就调用它。
WM_CAP_SET_CALLBACK_FRAME
CapSetCallbackOnFrame宏
在应用程序中指定回调函数,当预览图像帧被捕获了的时候就调用它。
WM_CAP_SET_CALLBACK_STATUS
CapSetCallbackOnStatus宏
在应用程序中指定回调函数,当状态(status)改变的时候就调用它。
WM_CAP_SET_CALLBACK_VIDEOSTREAM
CapSetCallbackOnVideoStream宏
在应用程序中指定回调函数,在流捕获期间,当一个新的视频缓存区可用的时候就调用它。
WM_CAP_SET_CALLBACK_WAVESTREAM
CapSetCallbackOnWaveStream宏
在应用程序中指定回调函数,在流捕获期间,当一个新的音频缓存区可用的时候就调用它。
WM_CAP_SET_CALLBACK_YIELD
CapSetCallbackOnYield宏
在应用程序中指定回调函数,在流捕获期间Yielding(产生?)

 
精确捕获控制
捕获窗口可以提供捕获回调函数,这个回调函数可以对流捕获的开始和结束时刻进行精确的控制。在捕获驱动程序(capture driver)完成所有缓存区分配和其他捕获准备后,捕获驱动程序就发送第一个消息给回调处理程序,把nState参数设置为:
CONTROLCALLBACK_PREROLL
这个消息告诉应用程序将要开启视频源了。(这个回调函数指定nState为它的第二个参数)回调函数将在开始时刻产生返回值。返回值为TRUE那么将继续捕获。为FALSE就中断捕获。一旦捕获开始,这个回调函数将频繁的调用,把nState设置为:
CONTROLCALLBACK_CAPTURING
将允许应用程序通过返回false去结束捕获。
 
错 误
       捕获窗口使用错误通知消息去告诉你的应用程序,发生了AVICap错误,比如磁盘空间已经用完了,尝试对一个只读文件进行写操作,不能访问硬件,掉帧太多。错误通知内容报价一个消息ID和一个格式化的文本字符(用来显示)。你的应用程序可以通过使用这个消息ID去过滤错误通报,还可以让该错误信息不显示给用户。消息ID为0表示一个新操作正在开始并且这个回调函数会清除掉所有的显示的错误信息。
 
帧(Frame)
       A capture window uses frame callback notification messages to notify your application when a new video frame is available. The capture window enables these callback notifications only if the preview rate is nonzero and streaming capture is not in progress.
 
状态回调函数
当视频捕获向磁盘写数据,或者在其他较长的操作期间,捕获窗口可以发送消息给状态回调函数通知你正在处理该操作的应用程序。状态信息包括一个消息ID和和一个格式化的文本字符(用来显示)。你的应用程序可以通过使用消息ID去过滤通报,还可以限制该信息是否显示给用户。在捕获操作期间,发给回调函数的第一个消息总是ID_CAP_GEGIN,最后一个总是ID_CAP_END。消息ID为0表示,一个新操作正在进行并且回调函数将清除当前状态。
 
视频流
       在流捕获期间,应用程序可以使用视频流回调函数去处理一个捕获的视频帧。视频窗体只能在每次向磁盘写数据帧前,调用视频流回调函数。
 
音频流
在流捕获期间,应用程序可以使用音频流回调函数去处理音频缓存区。视频窗体只能在每次向磁盘写数据帧前,调用音频流回调函数。
 
Yield 回调函数
应用程序在流捕获期间可以使用Yield回调函数。(Yield回调函数一般是由一个消息循环组成,可以调用PeekMessage,TranslateMessage,DispatchMessage)。捕获窗口在每次捕获视频帧时至少调用一次Yield回调函数。但是具体要调用多少次由帧率来决定。
 
关闭回调函数
你可以暂时或永久关闭所有的回调函数的功能,在发送消息设置回调函数的时候,用NULL替换调回调函数就可以了。
3.2使用视频捕获
3.2.1创建捕获窗体

 

下面的例子通过使用capCreateCaptureWindow函数来创建一个捕获窗体
hWndC = capCreateCaptureWindow (
    (LPSTR) "My Capture Window",       // 如果是Pop-up窗口的窗口名称
    WS_CHILD | WS_VISIBLE,          // 窗口类型
    0, 0, 160, 120,                      // 窗口位置和尺寸
    (HWND) hwndParent,
    (int) nID /* child ID */);

 

3.2.2连接到一个捕获驱动器

 

下面举例,如何通过捕获窗口的句柄hWndC连接到MS VIDEO驱动程序上,同时还演示了如何断开连接。使用capDriverDisconnect:
fOK = SendMessage (hWndC, WM_CAP_DRIVER_CONNECT, 0, 0L);

// 或者使用宏连接:

// fOK = capDriverConnect(hWndC, 0);

 

// 关闭连接
capDriverDisconnect (hWndC);

 

3.2.3列举安装的捕获驱动程序

 

使用capGetDriverDescription 函数来获得系统已经安装的所有捕获驱动程序的名称和版本。
char szDeviceName[80];
char szDeviceVersion[80];
for (wIndex = 0; wIndex < 10; wIndex++)
{
    if (capGetDriverDescription (wIndex, szDeviceName,
        sizeof (szDeviceName), szDeviceVersion,
        sizeof (szDeviceVersion))
    {

        // 加入名字到一个已经安装的设备列表中

        // 让用户选择一个使用。
    }
}

 

 

3.2.4获得捕获驱动器的性能参数

 

       WM_CAP_DRIVER_GET_CAPS消息可以返回捕获驱动程序以及其硬件的性能参数。这些信息存放在一个CAPDRIVERCAPS的数据结构中。当你的应用程序的捕获窗口连接到一个新的捕获驱动器后,都会刷新这个CAPDRIVERCAPS数据结构。下面将使用capDriverGetCaps宏来获得捕获设备的性能参数。
CAPDRIVERCAPS CapDrvCaps;
SendMessage (hWndC, WM_CAP_DRIVER_GET_CAPS,
    sizeof (CAPDRIVERCAPS), (LONG) (LPVOID) &CapDrvCaps);

// 或者,使用宏来获得驱动器的新能参数

// capDriverGetCaps(hWndC, &CapDrvCaps, sizeof (CAPDRIVERCAPS));

 

3.2.5获得捕获窗口状态(Status)

 

下面例子使用SetWindowPos函数区设置捕获窗口的尺寸,这个尺寸的大小是基于输入的视频流大小的。输入视频流的尺寸大小由capGetStatus宏来获得,获得信息放在一个CAPSTATUS的数据结构体中。

 

CAPSTATUS CapStatus;
capGetStatus(hWndC, &CapStatus, sizeof (CAPSTATUS));
SetWindowPos(hWndC, NULL, 0, 0, CapStatus.uiImageWidth,
             CapStatus.uiImageHeight, SWP_NOZORDER | SWP_NOMOVE);
3.2.6显示对话框区设置视频属性

 

       每个捕获驱动器都可以提高3个以上的不同对话框来控制数字视频的特性和捕获处理。下面的例子示范如何显示这些对话框。在显示每个对话框前,该例会调用capDriverGetCaps宏并且检查返回的CAPDRIVERCAPS对象来查看是否可以能够显示特定的对话框。

 

CAPDRIVERCAPS CapDrvCaps;
capDriverGetCaps(hWndC, &CapDrvCaps, sizeof (CAPDRIVERCAPS)); 

// 视频源对话框

if (CapDriverCaps.fHasDlgVideoSource)
    capDlgVideoSource(hWndC); 

// 视频格式对话框

if (CapDriverCaps.fHasDlgVideoFormat)
{
    capDlgVideoFormat(hWndC);

   // 是否由新的图像尺寸?Are there new image dimensions?

    capGetStatus(hWndC, &CapStatus, sizeof (CAPSTATUS));

   // 如果有,发送通知给父窗口,告诉它尺寸改变了

// 视频显示对话框

if (CapDriverCaps.fHasDlgVideoDisplay)
    capDlgVideoDisplay(hWndC);

 

3.2.7获得和设定视频格式

 

BITMAPINFO数据结构体可以实现长度可调节地去适应标准压缩的数据格式。因为它的长度可以变,所以在每次获得当前视频格式前,都必须去查询这个结构的长度以及分配的内存大小。该例子使用了capGetVideoFormatSize宏去获得缓存区大小,使用capGetVideoFormat宏区获得当前视频格式。

 

LPBITMAPINFO lpbi;
DWORD dwSize;

 

dwSize = capGetVideoFormatSize(hWndC);
lpbi = GlobalAllocPtr (GHND, dwSize);
capGetVideoFormat(hWndC, lpbi, dwSize);

 

// 访问视频格式,并且释放分配的内存。

 

应用程序使用capSetVideoFormat宏(WM_CAP_SET_VIDEOFORMAT),把一个BITMAPINFO结构发送给捕获窗口,显示修改。因为视频格式由设备指定的,你的应用程序可以去检查获得的返回值,来知道这个视频格式是不是公开的。

 

3.2.8预览视频
       下面使用capPreviewRate宏来设置预览模式的帧频率为66毫秒/帧,使用capPreview宏在捕获窗口预览图像。

 

capPreviewRate(hWndC, 66);      // 速度,微秒

capPreview(hWndC, TRUE);       // 开始预览

 

capPreview(hWnd, FALSE);        // 屏蔽预览

 

3.2.9允许视频覆盖(Overlay)

 

下面使用capDriverGetCaps宏去检测这个捕获驱动是否支持覆盖(Overlay)模式,如果支持,就允许视频覆盖模式;

 

CAPDRIVERCAPS CapDrvCaps;
capDriverGetCaps(hWndC, &CapDrvCaps, sizeof (CAPDRIVERCAPS));
if (CapDrvCaps.fHasOverlay)
    capOverlay(hWndC, TRUE);
 

 

3.2.10捕获文件命名

 

    下例使用capFileSetCaptureFile宏来指定一个要命名的文件名(mycap.avi),使用capFileAlloc宏去预分配5MB的文件。

 

char szCaptureFile[] = "MYCAP.AVI";
capFileSetCaptureFile( hWndC, szCaptureFile);
capFileAlloc( hWndC, (1024L * 1024L * 5));
 
3.2.11格式化音频捕获

 

下例使用capSetAudioFormat来设置音频格式为11-KHz PCM 8-bit,立体声。

 

WAVEFORMATEX wfex;
wfex.wFormatTag = WAVE_FORMAT_PCM;
wfex.nChannels = 2;                     // 使用立体声
wfex.nSamplesPerSec = 11025;
wfex.nAvgBytesPerSec = 22050;
wfex.nBlockAlign = 2;
wfex.wBitsPerSample = 8;
wfex.cbSize = 0;
capSetAudioFormat(hWndC, &wfex, sizeof(WAVEFORMATEX));

 

3.2.12改变视频捕获设置

 

       下例使用capCaptureGetSetup和capCaptureSetSetup宏来改变捕获速度,从默认值(15帧/秒)到10帧/秒。

 

CAPTUREPARMS CaptureParms;
float FramesPerSec = 10.0;
capCaptureGetSetup(hWndC, &CaptureParms, sizeof(CAPTUREPARMS));
CaptureParms.dwRequestMicroSecPerFrame = (DWORD) (1.0e6 /
    FramesPerSec);
capCaptureSetSetup(hWndC, &CaptureParms, sizeof (CAPTUREPARMS));

 

3.2.13捕获数据

 

       下例使用capCaptureSequence宏开始视频捕获,使用capFileSaveAs宏从捕获文件拷贝数据到其他文件NEWFILE.AVI中。

 

char szNewName[] = "NEWFILE.AVI";
// Set up the capture operation.
capCaptureSequence(hWndC);
// Capture.
capFileSaveAs(hWndC, szNewName);

 

3.2.14加入信息块

 

如果你想添加其他信息(除了音视频),你可以建一个信息块并把它们插入到一个捕获文件中去。信息块可以包含这个方面的内容。比如版权信息,视频源的ID,外部显示的时间信息。下面的例子保存外部时间信息SMPTE()到一个信息块中,并加入使用capFileSetInfoChunk宏加入到捕获文件中。

 

// This example assumes the application controls

// the video source for preroll and postroll.
CAPINFOCHUNK cic;
// .
// .
// .
cic.fccInfoID = infotypeSMPTE_TIME;
cic.lpData = "00:20:30:12";
cic.cbData = strlen (cic.lpData) + 1;
capFileSetInfoChunk (hwndC, &cic);

 

3.2.15在程序中加入回调函数
应用程序可以注册捕获窗口的回调函数,这样就可以把下面的情况通知给应用程序:
l         状态变化了
l         错误发生了
l         视频和音频的缓冲区的数据可以使用了
l         在捕获期间,应用程序将yield
下面的例子将创建一个捕获窗口并在应用的消息循环中,注状态、错误、视频流、帧的回调函数。

 

case WM_CREATE:
{
    char    achDeviceName[80] ;
    char    achDeviceVersion[100] ;
    char    achBuffer[100] ;
    WORD    wDriverCount = 0 ;
    WORD    wIndex ;
    WORD    wError ;
    HMENU   hMenu ;
 

    // 使用capCreateCaptureWindow宏创建一个捕获窗体.

    ghWndCap = capCreateCaptureWindow((LPSTR)"Capture Window",
        WS_CHILD | WS_VISIBLE, 0, 0, 160, 120, (HWND) hWnd, (int) 0);
 

    // 使用capSetCallbackOnError宏注册错误回调函数

     capSetCallbackOnError(ghWndCap, fpErrorCallback);
 

    // 使用capSetCallbackOnStatus宏注册状态回调函数

    capSetCallbackOnStatus(ghWndCap, fpStatusCallback);
 
    //使用capSetCallbackOnVideoStream宏注册视频流回调函数
    capSetCallbackOnVideoStream(ghWndCap, fpVideoCallback);
 
    //使用capSetCallbackOnFrame宏注册帧回调函数
    capSetCallbackOnFrame(ghWndCap, fpFrameCallback);
 

    // 连接到一个捕获驱动器上

 

    break;
}
case WM_CLOSE:
{
//使用capSetCallbackOnFrame宏关闭帧回调函数

// 类似可调用其他存在的回调函数。

 

    capSetCallbackOnFrame(hWndC, NULL);
 break;
}
 

 

 

3.2.16创建一个状态回调函数

 

下面的例子是一个简单的状态回调函数,使用capSetCallbackOnStatus宏来注册这个回调函数。

// StatusCallbackProc: 状态回调函数

// hWnd:            捕获窗体句柄

// nID:              当前状态的状态码

// lpStatusText:       当前状态的文本字符
//
LRESULT PASCAL StatusCallbackProc(HWND hWnd, int nID,
    LPSTR lpStatusText)
{
    if (!ghWndMain)
        return FALSE;
 
    if (nID == 0) {           // 清除旧的状态信息
        SetWindowText(ghWndMain, (LPSTR) gachAppName);
        return (LRESULT) TRUE;
    }

    // 显示状态ID和状态文本..

    wsprintf(gachBuffer, "Status# %d: %s", nID, lpStatusText);
 
    SetWindowText(ghWndMain, (LPSTR)gachBuffer);
    return (LRESULT) TRUE;
}
 
3.2.17创建一个错误的回调函数

 

下面例子是一个简单的错误回调函数。通过capSetCallbackOnError宏来注册回调。

// ErrorCallbackProc:    错误回调函数

// hWnd:              捕获窗口句柄

// nErrID:              错误代码

// lpErrorText:          关于错误的文本信息
//
LRESULT PASCAL ErrorCallbackProc(HWND hWnd, int nErrID,
    LPSTR lpErrorText)
{
 
    if (!ghWndMain)
        return FALSE;
 
    if (nErrID == 0)            // Starting a new major function.
        return TRUE;          // 清除旧的错误
 

    // 显示错误ID和错误文本信息

    wsprintf(gachBuffer, "Error# %d", nErrID);
 
    MessageBox(hWnd, lpErrorText, gachBuffer,
               MB_OK | MB_ICONEXCLAMATION);
 
    return (LRESULT) TRUE;
}

 

3.2.18创建一个帧回调函数

 

下面是一个简单的帧回调函数。通过capSetCallbackFrame宏来注册回调函数。

 

// FrameCallbackProc:   帧回调函数

// hWnd:              捕获窗体句柄

// lpVHdr:             指向一个包含帧信息的数据结构体
//
LRESULT PASCAL FrameCallbackProc(HWND hWnd, LPVIDEOHDR lpVHdr)
{
    if (!ghWndMain)
        return FALSE;
 
    wsprintf(gachBuffer, "Preview frame# %ld ", gdwFrameNum++);
    SetWindowText(ghWndMain, (LPSTR)gachBuffer);
    return (LRESULT) TRUE ;
}
原文地址:https://www.cnblogs.com/hzcya1995/p/13318735.html