AMCAP程序详解

爱被打了一巴掌 2022-08-08 14:49 303阅读 0赞

## AMCAP程序详解 ##

<table> 
 <tbody> 
 <tr> 
 <td> AMCAP程序详解<a rel="nofollow"></a></td> 
 </tr> 
 <tr> 
 <td> 
 <div> 
 文章原始出处 CSDN 作者 capboy 
 &nbsp;&nbsp;&nbsp;&nbsp;DirectShow提供了用应用程序从适当的硬件中捕捉和预览音/视频的能力。数据源包括：VCR，Camera,TVTuner,Microphone,或其他的数据源。一个应用程序可以立刻显示捕捉的数据(预览)，或是保存到一个文件中。 
 &nbsp;&nbsp;&nbsp;&nbsp;在这个例子中，ICaptureGraphBuilder接口是处理捕捉工作的主要接口。你可以在你自己的捕捉程序中使用同样的方法和接口。在这里主要讨论ICaptureGraphBuilder如何执行音/视频的捕捉。我们假设你已经熟悉了DirectShow的filtergraph的体系和一般的capturefiltergraph的结构(可以参考DirectShow基础指南)。 
 &nbsp;&nbsp;&nbsp;&nbsp;ICaptureGraphBuilder接口提供了一个filtergraph builder对象，让你的应用程序在建立capture filtergraph时，省去处理很多单调乏味的工作，集中精力于捕捉中。它提供的方法满足了基本的捕捉和预览功能的要求。 
 &nbsp;&nbsp;&nbsp;&nbsp;FindInterface方法，在filtergraph中查找一个与捕捉有关的详细的接口。使得你可以访问一个详细接口的功能，而不需要你去列举filtergraph中的pins和filters。 &nbsp;&nbsp;&nbsp;&nbsp;RenderStream方法，连接源过滤器和渲染过滤器，选择添加一些中间的过滤器。 &nbsp;&nbsp;ControlStream方法，独立地精确地控制graph的开始和结束帧。 
 &nbsp;&nbsp;&nbsp;&nbsp;既然是硬件捕捉，当然要和硬件打交道，接着介绍设备列举和捕捉接口。 
 &nbsp;&nbsp;&nbsp;&nbsp;通过ICreateDevEnum::CreateClassEnumerator方法列举捕捉系统中的设备。之后，实例化一个DirectShow的filter去使用这个设备。 &nbsp;用ICaptureGraphBuilder::FindInterface去获得与捕捉相关的接口指针IAMDroppedFrames,IAMVideoCompression, IAMStreamConfig,以及 IAMVfwCaptureDialogs。因为设备列举和捕捉接口比较长，放在这会打乱结构，所有专门写了一篇(参考<a href="http://skygray.ee.tokushima-u.ac.jp/%7Ewangfei/research/vc/directx.html#DX3" rel="nofollow">设备列举和捕捉接口</a>)。 
 <table> 
 <tbody> 
 <tr> 
 <td>NOTE： &nbsp;&nbsp;&nbsp;这个示例是DirectShow自带的例子。你可以在DirectShowSDK的目录Sample\DS\Caputre看这个例子代码(AMCap.cpp)。这里只是他的一些片断代码。可以说是他的中文模块的说明。AMCap例子中，把所有的接口指针和一些成员变量保存在一个全局结构gcap中了。</td> 
 </tr> 
 </tbody> 
 </table> 
 &nbsp;&nbsp;&nbsp;&nbsp;当不在需要保存在gcap中的接口指针是，一定要释放这些接口指针，一般是在程序的析构函数中，或是在别的同等功能函数中。如下： 
 <table> 
 <tbody> 
 <tr> 
 <td>if (gcap.pBuilder) gcap.pBuilder-&gt;Release(); gcap.pBuilder = NULL; if (gcap.pSink) gcap.pSink-&gt;Release(); gcap.pSink = NULL; if (gcap.pConfigAviMux) gcap.pConfigAviMux-&gt;Release(); gcap.pConfigAviMux = NULL; if (gcap.pRender) gcap.pRender-&gt;Release(); gcap.pRender = NULL; if (gcap.pVW) gcap.pVW-&gt;Release(); gcap.pVW = NULL; if (gcap.pME) gcap.pME-&gt;Release(); gcap.pME = NULL; if (gcap.pFg) gcap.pFg-&gt;Release(); gcap.pFg = NULL;</td> 
 </tr> 
 </tbody> 
 </table> 
 设置文件名 
 &nbsp;&nbsp;&nbsp;使用普通的OpenFileDialog获得捕捉文件的信息。通过调用AllocCaptureFile函数为捕捉文件分配空间。这一点是重要的，因为这是个巨大的空间。这样可以提高捕捉操作的速度。ICaptureGraphBuilder::AllocCapFile执行实际的文件分配，IFileSinkFilter::SetFileName指示file writerfilter使用用户选择的文件名保存数据。ICaptureGraphBuilder::SetOutputFileName把filewriter filter加入filter graph(后面会介绍，它是ICaptureGraphBuilderd自代的)。 
 SetCaptureFile 和 AllocCaptureFile 函数如下： 
 <table> 
 <tbody> 
 <tr> 
 <td> BOOL SetCaptureFile(HWND hWnd) { &nbsp;&nbsp;&nbsp;&nbsp;if(OpenFileDialog(hWnd, gcap.szCaptureFile, _MAX_PATH)) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;OFSTRUCTos; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//We have a capture file name &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if(OpenFile(gcap.szCaptureFile, &amp;os, OF_EXIST) ==HFILE_ERROR) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//Bring up dialog, and set new file size &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;BOOLf = AllocCaptureFile(hWnd); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if(!f) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;returnFALSE; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;else{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;returnFALSE; &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;SetAppCaption();// need a new app caption &nbsp;&nbsp;&nbsp;&nbsp;//Tell the file writer to use the new file name &nbsp;&nbsp;&nbsp;&nbsp;if(gcap.pSink) { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;WCHARwach[_MAX_PATH]; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;MultiByteToWideChar(CP_ACP,MB_PRECOMPOSED, gcap.szCaptureFile, -1, wach, _MAX_PATH); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;gcap.pSink-&gt;SetFileName(wach,NULL); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp; return TRUE; } // Preallocate the capturefile // BOOL AllocCaptureFile(HWND hWnd) { // We'll get into an infinite loop in the dlgproc setting a value if (gcap.szCaptureFile[0] == 0) &nbsp;&nbsp;&nbsp;&nbsp;returnFALSE; if (DoDialog(hWnd, IDD_AllocCapFileSpace, AllocCapFileProc, 0)){ &nbsp;&nbsp;&nbsp;&nbsp;//Ensure repaint after dismissing dialog before &nbsp;&nbsp;&nbsp;&nbsp;//possibly lengthy operation &nbsp;&nbsp;&nbsp;&nbsp;UpdateWindow(ghwndApp); &nbsp;&nbsp;&nbsp;&nbsp;//User has hit OK. Alloc requested capture file space &nbsp;&nbsp;&nbsp;&nbsp;BOOLf = MakeBuilder(); &nbsp;&nbsp;&nbsp;&nbsp;if(!f) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;returnFALSE; &nbsp;&nbsp;&nbsp;&nbsp;WCHARwach[_MAX_PATH]; &nbsp;&nbsp;&nbsp;&nbsp;MultiByteToWideChar(CP_ACP,MB_PRECOMPOSED, gcap.szCaptureFile, -1, wach, _MAX_PATH); &nbsp;&nbsp;&nbsp;&nbsp;if(gcap.pBuilder-&gt;AllocCapFile(wach,gcap.wCapFileSize* 1024L * 1024L) != NOERROR) { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;MessageBoxA(ghwndApp, "Error","Failed to pre-allocate capture filespace",MB_OK | MB_ICONEXCLAMATION); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return FALSE; &nbsp;&nbsp; &nbsp;} &nbsp;&nbsp;&nbsp; returnTRUE; } else { &nbsp;&nbsp;&nbsp;&nbsp;returnFALSE; } } </td> 
 </tr> 
 </tbody> 
 </table> 
 建立GraphBuilder对象 
 &nbsp;&nbsp;&nbsp;&nbsp;AMCap的MakeBuilder函数建立了一个capturegraph builer对象，通过调用 CoCreateInstance获得了ICaptureGraphBuilder接口指针。AMCap把他存储到gcap结构的pBuilder中。 
 <table> 
 <tbody> 
 <tr> 
 <td> // Make a graph builderobject we can use for capture graph building // BOOL MakeBuilder() { &nbsp;&nbsp;&nbsp;&nbsp;//We have one already &nbsp;&nbsp;&nbsp;&nbsp;if(gcap.pBuilder) &nbsp;&nbsp;&nbsp;&nbsp;returnTRUE; &nbsp;&nbsp;&nbsp;&nbsp;HRESULThr = CoCreateInstance((REFCLSID)CLSID_CaptureGraphBuilder, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NULL,CLSCTX_INPROC, (REFIID)IID_ICaptureGraphBuilder,(void**)&amp;gcap.pBuilder); &nbsp;&nbsp;&nbsp;&nbsp;return(hr == NOERROR) ? TRUE : FALSE; } </td> 
 </tr> 
 </tbody> 
 </table> 
 建立Graph的渲染部分，并告诉它写文件(用先前决定的文件) 
 &nbsp;&nbsp;&nbsp;&nbsp;这包括一个multiplexerfilter 和 file writer。DirectShow 提供了一个AVIMUX(multiplexer)filter。 &nbsp;&nbsp;&nbsp;&nbsp;在这里ICaptureGraphBuilder::SetOutputFileName是一个关键的方法。它把multiplexer 和 file writer添加到filtergraph中，连接他们，并设置文件的名字。第一个参数MEDIASUBTYPE_Avi，指出capture graph builder对象将插入一个AVI multiplexer filter，因此，filewriter将以AVI文件格式记录捕捉的数据。第二个参数(wach)是文件名。最后的两个参数指出multiplexer filter(gcap.pRender) 和file writer filter(gcap.pSink)，这两个是通过SetOutputFileName函数初始化的。AMCap存储这些指针到全局结构gcap中。capture graph builder 对象建立了一个filtergraph对象(IGraphBuilder)，把这两个filter加入到filter graph中去。他告诉filewriter使用指定的文件保存数据。下面的例子演示了如何调用SetOutputFileName。 
 <table> 
 <tbody> 
 <tr> 
 <td> // // We need a rendering section that will write the capture file outin AVI // file format // WCHAR wach[_MAX_PATH]; MultiByteToWideChar(CP_ACP, MB_PRECOMPOSED, gcap.szCaptureFile, -1,wach, _MAX_PATH); GUID guid = MEDIASUBTYPE_Avi; hr =gcap.pBuilder-&gt;SetOutputFileName(&amp;guid,wach, &amp;gcap.pRender,&amp;gcap.pSink); if (hr != NOERROR) { &nbsp;&nbsp;&nbsp;&nbsp;ErrMsg("Error%x: Cannot set output file", hr); &nbsp;&nbsp;&nbsp;&nbsp;gotoSetupCaptureFail; } </td> 
 </tr> 
 </tbody> 
 </table> 
 获得当前的FilterGraph 
 &nbsp;&nbsp;&nbsp;&nbsp;因为在调用SetOutputFileName中，capturegraph builder 对象建立了一个filter graph，所以你必须把需要的filter加入同一个filter graph中。通过ICaptureGraphBuilder::GetFiltergraph获得新建立的filtergraph。返回的指针是参数gcap.pFg。 
 <table> 
 <tbody> 
 <tr> 
 <td> // // The graph builder created a filter graph to do that. Find outwhat it is, // and put the video capture filter in the graph too. // hr =gcap.pBuilder-&gt;GetFiltergraph(&amp;gcap.pFg); if (hr != NOERROR) { &nbsp;&nbsp;&nbsp;&nbsp;ErrMsg("Error%x: Cannot get filtergraph", hr); &nbsp;&nbsp;&nbsp;&nbsp;gotoSetupCaptureFail; } </td> 
 </tr> 
 </tbody> 
 </table> 
 添加音/视频过滤器到当前的Filter Graph 
 <table> 
 <tbody> 
 <tr> 
 <td> hr =gcap.pFg-&gt;AddFilter(gcap.pVCap, NULL); if (hr != NOERROR) { &nbsp;&nbsp;&nbsp;&nbsp;ErrMsg("Error%x: Cannot add vidcap to filtergraph", hr); &nbsp;&nbsp;&nbsp;&nbsp;gotoSetupPreviewFail; } hr =gcap.pFg-&gt;AddFilter(gcap.pACap, NULL); if (hr != NOERROR) { &nbsp;&nbsp;&nbsp;&nbsp;ErrMsg("Error%x: Cannot add audcap to filtergraph", hr); &nbsp;&nbsp;&nbsp;&nbsp;gotoSetupCaptureFail; } </td> 
 </tr> 
 </tbody> 
 </table> 
 渲染视频捕捉过滤器的CapturePin和音频捕捉的Capture Pin 
 &nbsp;&nbsp;&nbsp;&nbsp;ICaptureGraphBuilder::RenderStream连接源过滤器的pin到渲染过滤器。pin的类别是可选的，capture pin (PIN_CATEGORY_CAPTURE) 或preview pin (PIN_CATEGORY_PREVIEW)。下面的例子演示了连接video capture filter(gcap.pVCap) 的capture pin到渲染gcap.pRender中。 
 <table> 
 <tbody> 
 <tr> 
 <td> // // Render the video capture and preview pins - we may not havepreview, so // don't worry if it doesn't work // hr =gcap.pBuilder-&gt;RenderStream(&amp;PIN_CATEGORY_CAPTURE,NULL, gcap.pVCap, NULL, gcap.pRender); // Error checking // // Render the audio capture pin? // if (gcap.fCapAudio) { hr =gcap.pBuilder-&gt;RenderStream(&amp;PIN_CATEGORY_CAPTURE,NULL, gcap.pACap, NULL, gcap.pRender); // Error checking </td> 
 </tr> 
 </tbody> 
 </table> 
 渲染Video CaptureFilter的 Preview Pin 
 &nbsp;&nbsp;&nbsp;&nbsp;再次调用ICaptureGraphBuilder::RenderStream，从capture filter的previewpin到video renderer。代码如下： 
 <table> 
 <tbody> 
 <tr> 
 <td> hr =gcap.pBuilder-&gt;RenderStream(&amp;PIN_CATEGORY_PREVIEW,NULL, gcap.pVCap, NULL, NULL); </td> 
 </tr> 
 </tbody> 
 </table> 
 获得访问Video PreviewWindow的接口指针 
 &nbsp;&nbsp;&nbsp;&nbsp;缺省的，videopreview window是一个独立的窗口。如果你想改变默认的行为，先调用ICaptureGraphBuilder::FindInterface获得IVideoWindow接口。第二个参数通过gcap.pVCap指定，描述video capturefilter，第三个参数是想得到的接口(IVideoWindow)，最后的是返回的接口。当你得到IVideoWindow接口后，你可以调用IVideoWindow的方法象put_Owner,put_WindowStyle, or SetWindowPosition 去获得video previewwindow的handle，设置窗口属性，或把他放到想要的位置。 
 <table> 
 <tbody> 
 <tr> 
 <td> // This will go through apossible decoder, find the video renderer it's // connected to, and get the IVideoWindow interface onit hr =gcap.pBuilder-&gt;FindInterface(&amp;PIN_CATEGORY_PREVIEW,gcap.pVCap, IID_IVideoWindow, (void**)&amp;gcap.pVW); if (hr != NOERROR) { &nbsp;&nbsp;&nbsp;&nbsp;ErrMsg("Thisgraph cannot preview"); } else { &nbsp;&nbsp;&nbsp;&nbsp;RECTrc; &nbsp;&nbsp;&nbsp;&nbsp;gcap.pVW-&gt;put_Owner((long)ghwndApp);// We own the window now &nbsp;&nbsp;&nbsp;&nbsp;gcap.pVW-&gt;put_WindowStyle(WS_CHILD);// you are now a child &nbsp;&nbsp;&nbsp;&nbsp;//give the preview window all our space but where the status baris &nbsp;&nbsp;&nbsp;&nbsp;GetClientRect(ghwndApp,&amp;rc); &nbsp;&nbsp;&nbsp;&nbsp;cyBorder= GetSystemMetrics(SM_CYBORDER); &nbsp;&nbsp;&nbsp;&nbsp;cy= statusGetHeight() + cyBorder; &nbsp;&nbsp;&nbsp;&nbsp;rc.bottom-= cy; &nbsp;&nbsp;&nbsp;&nbsp;gcap.pVW-&gt;SetWindowPosition(0,0, rc.right, rc.bottom); // be thisbig &nbsp;&nbsp;&nbsp;&nbsp;gcap.pVW-&gt;put_Visible(OATRUE); } </td> 
 </tr> 
 </tbody> 
 </table> 
 现在你已经建立完整的capture filtergraph了，你可以预览音频，视频，或捕捉数据。 
 控制 Capture FilterGraph 
 &nbsp;&nbsp;&nbsp;&nbsp;因为通过ICaptureGraphBuilder接口构造的capturefilter graph 只是一个简单的专门用途的filter graph，所以，控制它就象控制其他类型的filtergraph一样。你可以使用IMediaControl interface的 Run, Pause,和Stop方法，你也可以使用CBaseFilter::Pause的方法。另外ICaptureGraphBuilder 提供了ControlStream 方法去来控制 capture filter graph的流媒体的开始和结束时间。ControlStream调用IAMStreamControl::StartAt 和IAMStreamControl::StopAt控制filter graph的捕捉和预览的开始和结束的位置。 
 <table> 
 <tbody> 
 <tr> 
 <td> 注意：不是所有的capture filter都可以，因为不是每一个capturefilter都支持IAMStreamControl。 </td> 
 </tr> 
 </tbody> 
 </table> 
 &nbsp;&nbsp;&nbsp;ICaptureGraphBuilder::ControlStream方法的第一个参数(pCategory)是一个输出pin类的GUID。这个变量通常是PIN_CATEGORY_CAPTURE或 PIN_CATEGORY_PREVIEW。指定为NULL则控制所有的capture filter。 &nbsp;&nbsp;&nbsp;&nbsp;第二个参数在(pFilter)指出那个filter控制。NULL说明为控制所有的filtergraph。 &nbsp;&nbsp;&nbsp;&nbsp;如果只是预览(防止捕捉)的话，可以调用ICaptureGraphBuilder::ControlStream，参数用capturepin类型，MAX_TIME作为开始时间(第三个参数，pstart)。再次调用该方法，参数用previewpin类型，NULL作为开始时间则立即开始预览。第四参数指出结束的时间(pstop),含义和第三个参数一样(NULL意味着立刻)。MAX_TIME在DirectShow中定义为最大的参考时间。在这里意味着忽略或取消指定的操作。 &nbsp;&nbsp;&nbsp;&nbsp;最后的参数，wStartCookie和wStopCookie分别是开始和结束的cookies(不知道该怎么翻译，因为我也不理解这个参数的含义)。 &nbsp;&nbsp;&nbsp;&nbsp;下面的代码设置立刻开始预览，但是忽略捕捉。 
 <table> 
 <tbody> 
 <tr> 
 <td> // Let the preview sectionrun, but not the capture section // (There might not be a capture section) REFERENCE_TIME start = MAX_TIME, stop = MAX_TIME; // show us a preview first? but don't capturequite yet... hr =gcap.pBuilder-&gt;ControlStream(&amp;PIN_CATEGORY_PREVIEW,NULL, gcap.fWantPreview ? NULL : &amp;start, gcap.fWantPreview ? &amp;stop : NULL, 0, 0); if (SUCCEEDED(hr)) &nbsp;&nbsp;&nbsp;&nbsp;hr=gcap.pBuilder-&gt;ControlStream(&amp;PIN_CATEGORY_CAPTURE,NULL, &amp;start, NULL, 0, 0); </td> 
 </tr> 
 </tbody> 
 </table> 
 &nbsp;&nbsp;&nbsp;&nbsp;同样的，如果你只想要捕捉而不要预览，设置捕捉的开始时间为NULL，设置捕捉的结束时间为MAX_TIME。设置预览的开始时间为MAX_TIME，NULL为结束时间。 &nbsp;&nbsp;&nbsp;&nbsp;下面的例子告诉filtergraph开始预览(第三个参数：开始时间为NULL)。结束时间指定为MAX_TIME意味着忽视停止时间(永远放下去)。 gcap.pBuilder-&gt;ControlStream(&amp;PIN_CATEGORY_PREVIEW,NULL, NULL, MAX_TIME, 0, 0); 
 调用IMediaControl::Run 运行 graph 
 <table> 
 <tbody> 
 <tr> 
 <td> // Run the graph IMediaControl *pMC = NULL; HRESULT hr =gcap.pFg-&gt;QueryInterface(IID_IMediaControl, (void**)&amp;pMC); if (SUCCEEDED(hr)) { &nbsp;&nbsp;&nbsp;&nbsp;hr= pMC-&gt;Run(); &nbsp;&nbsp;&nbsp;&nbsp;if(FAILED(hr)) { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//Stop parts that ran &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pMC-&gt;Stop(); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;pMC-&gt;Release(); } if (FAILED(hr)) { &nbsp;&nbsp;&nbsp;&nbsp;ErrMsg("Error%x: Cannot run preview graph", hr); &nbsp;&nbsp;&nbsp;&nbsp;returnFALSE; </td> 
 </tr> 
 </tbody> 
 </table> 
 &nbsp;&nbsp;&nbsp;&nbsp;如果graph已经运行，通过调用ICaptureGraphBuilder::ControlStream立刻开始捕捉。例如下面的代码，控制整个的filtergraph(第二个参数为NULL)，立刻开始(第三个参数是NULL)，并且永不停止(第四个参数是MAX_TIME)。 
 <table> 
 <tbody> 
 <tr> 
 <td> // NOW! gcap.pBuilder-&gt;ControlStream(&amp;PIN_CATEGORY_CAPTURE,NULL, MAX_TIME, &amp;stop, 0, 0); </td> 
 </tr> 
 </tbody> 
 </table> 
 &nbsp;&nbsp;&nbsp;&nbsp;停止预览或捕捉操作，调用IMediaControl::Stop，就同你调用IMediaControl::Run一样。 
 <table> 
 <tbody> 
 <tr> 
 <td> // Stop the graph IMediaControl *pMC = NULL; HRESULT hr =gcap.pFg-&gt;QueryInterface(IID_IMediaControl, (void**)&amp;pMC); if (SUCCEEDED(hr)) { &nbsp;&nbsp;&nbsp;&nbsp;hr= pMC-&gt;Stop(); &nbsp;&nbsp;&nbsp;&nbsp;pMC-&gt;Release(); } </td> 
 </tr> 
 </tbody> 
 </table> 
 获得捕捉的信息 
 &nbsp;&nbsp;&nbsp;&nbsp;通过IAMDroppedFrames接口获得。测试丢失帧的数量(IAMDroppedFrames::GetNumDropped)，捕捉的数量(IAMDroppedFrames::GetNumNotDropped)。IAMDroppedFrames::GetAverageFrameSize方法提供了捕捉帧的平均尺寸(单位：byte)。使用这些信息可以知道总的捕捉字节和每秒的帧数(速率)。 
 保存文件 
 &nbsp;&nbsp;&nbsp;&nbsp;最初分配的捕捉文件只是临时的保存数据，所有你可以尽可能快的捕捉。当你想把捕捉的数据保存到硬盘中时，调用ICaptureGraphBuilder::CopyCaptureFile。这个方法从先前得到的捕捉文件输出数据到你选择的另一个文件中。这个新的储存文件的大小是和实际捕捉的数据匹配的，而不是和先前的文件大小匹配。ICaptureGraphBuilder::CopyCaptureFile方法的第一个参数是复制源，第二个是目标文件。第三个参数设为TRUE指出用户允许用ESC键中断复制操作。最后参数是可选的。允许你提供一个进程指示器。如果想要的化，通过执行IAMCopyCaptureFileProgress 接口。下面示例了如何调用CopyCaptureFile。 
 <table> 
 <tbody> 
 <tr> 
 <td> hr =pBuilder-&gt;CopyCaptureFile(wachSrcFile,wachDstFile,TRUE,NULL); </td> 
 </tr> 
 </tbody> 
 </table> 
 &nbsp;&nbsp;&nbsp;通过普通的OpenFile Dialog得到新的文件名。用 MultiByteToWideChar函数把文件名转成宽字符（widestring），使用ICaptureGraphBuilder::CopyCaptureFile把捕捉的数据保存到指定的文件中。 
 <table> 
 <tbody> 
 <tr> 
 <td> BOOL SaveCaptureFile(HWND hWnd) { HRESULT hr; char achDstFile[_MAX_PATH]; WCHAR wachDstFile[_MAX_PATH]; WCHAR wachSrcFile[_MAX_PATH]; if (gcap.pBuilder == NULL) &nbsp;&nbsp;&nbsp;&nbsp;returnFALSE; if (OpenFileDialog(hWnd, achDstFile, _MAX_PATH)){ // We have a capture filename MultiByteToWideChar(CP_ACP, MB_PRECOMPOSED, gcap.szCaptureFile, -1,wachSrcFile, _MAX_PATH); MultiByteToWideChar(CP_ACP, MB_PRECOMPOSED, achDstFile, -1,wachDstFile, _MAX_PATH); statusUpdateStatus(ghwndStatus, "Saving capture file - pleasewait..."); // We need our own graphbuilder because the main one might not exist ICaptureGraphBuilder *pBuilder; hr = CoCreateInstance((REFCLSID)CLSID_CaptureGraphBuilder, NULL, CLSCTX_INPROC, (REFIID)IID_ICaptureGraphBuilder, (void **)&amp;pBuilder); if (hr == NOERROR) { // Allow the user to press ESC to abort...don't ask for progress hr = pBuilder-&gt;CopyCaptureFile(wachSrcFile,wachDstFile,TRUE,NULL); pBuilder-&gt;Release(); } if (hr == S_OK) statusUpdateStatus(ghwndStatus, "Capture file saved"); else if (hr == S_FALSE) statusUpdateStatus(ghwndStatus, "Capture file save aborted"); else statusUpdateStatus(ghwndStatus, "Capture file save ERROR"); return (hr == NOERROR ? TRUE : FALSE); } else { return TRUE; // They canceled orsomething } } </td> 
 </tr> 
 </tbody> 
 </table> 
 关于捕捉媒体文件和获得捕捉信息的详细内容，可以参考AMCap例子的Amcap.cpp 和Status.cpp 。 
 </div> </td> 
 </tr> 
 </tbody> 
</table>