DirectShow重要接口

DirectShow重要接口

DirectShow 的重要接口

DirectShow采用了COM标准，所以很多重要的功能都是通过COM接口来完成。下面就列举一些重要的DirectShow的接口。

(1) IGraphBuilder接口

用于构造Filter Graph的接口，建立和管理一系列的Filter，过滤和处理源媒体流。

(2) IMediaControl接口

用于控制多媒体流在过滤器图表中的流动，如流的启动和停止。

(3) IMediaEvent接口

用于捕获播放过程中发生的事件，并通知应用程序，如EC_COMPLETE等。

(4) IVideoWindow接口

用于控制视频窗口的属性。

(5) IMeadiaSeeking接口

用于查找媒体的接口，定位流媒体，控制多媒体数据播放提供精确控制。

(6) IBaseFilter接口

从ImediaFilter接口继承，用来定义一个具体的过滤器指针，并对多媒体数据进行处理。

(7) IPin接口

用于管理两个过滤器之间的Pin，从而连接过滤器。

(8) IsampleGrabberCB接口

是Sample Grabber过滤器的一个接口，用于当流媒体数据通过过滤器时进行采样以获得帧图象。

用DirectShow来使用摄像头，一般要求摄像头的驱动是WDM格式的，当然，一些比较老的驱动格式DirectShow也可支持。在DirectShow中，有一个Sample Grabber过滤器，它是一个可以被插入流的过滤器，它有自己的缓冲，存放采样。我们就可以用它来从一个视频文件中简单的扑获一桢。DirectShow通过图形过滤管理器(Filter Graph Manager)来与上层应

用程序和下层的驱动进行联系。DirectShow通过捕获过滤器(Capture Filter)来支持对摄像头的捕获，一个捕获过滤器有多个插口(pin)，其中的预览(preview)插口可用来进行显示祯图象。

1、创建图形过滤管理器Filter Graph

如上面原理所述，首先要创建Filter Graph：

CComPtr＜IGraphBuilder ＞m_pGraph;

hr=m_pGraph.CoCreateInstance( CLSID_FilterGraph );

2、连接设备

还要创建系统枚举器组件对象：

CComPtr＜ICreateDevEnum＞

pCreateDevEnum;pCreateDevEnum.CoCreateInstance( CLSID_SystemDeviceEnu

m );

然后使用接口方法CreateClassEnumerator ()为指定的Filter注册类型目录创建一个枚举器，并获得IenumMoniker接口：

CComPtr＜IEnumMoniker ＞pEm;

pCreateDevEnum-＞CreateClassEnumerator(CLSID_VideoInputDeviceCategory,

&pEm, 0 );

接着在调用BindToObject()以后，可以将设备标识生成一个DirectShow Filter，将其加到Filter Graph中就可以参与工作了。

CComPtr＜IMoniker ＞pM;

CComPtr＜IPropertyBag ＞pBag;

hr=pM-＞BindToStorage(0,0,ID_IPropertyBag, (void**) &pBag );

3、创建Sample Grabber过滤器

CComPtr＜ISampleGrabber ＞m_pGrabber

hr=m_pGrabber.CoCreateInstance( CLSID_SampleGrabber );

当创建好SampleGrabber以后，在Sample Grabber 过滤器连接到别的过滤器之前你必须配置它。然后查询IsampleGrabber接口,还要设置流媒体类型:

m_pGrabber-＞SetMediaType（）；

可以仅仅指定主媒体类型；或者主类型加子类型；或者主类型，子类型和类型格式。然后就把它加载到FilterGraph中去：

m_pGraph-＞AddFilter(pGrabBase,"Grabber" );

4、查找Filter Graph 的Pin并完成后续连接。

接下来就可以通过调用IGraphBuilder 的FindPin（）接口来查找过滤管理器中的Pin接口，并通过ICaptureGraphBuilder2 中的接口RenderStream（）来完成后续的连接。

hr=pCGB2-＞FindPin(pCap,PINDIR_OUTPUT,&PIN_CATEGORY_VIDEOPORT, NULL,FALSE,0,&pVPPin);

hr=pCGB2-＞RenderStream(&PIN_CATEGORY_CAPTURE,&MEDIATYPE_Video, pCap,pGrabBase,pRenderer);

5、获取流媒体类型并运行

通过GetConnectedMediaType（）获取连接流媒体的类型以后，我们可以通过IsampleGrabberCB类的接口BufferCB（）来把视频的数据拷贝到自定义的缓冲区中，然后通过在缓冲区的拷贝进行视频到图象数据的拷贝。最后运行﹕

CComQIPtr＜IMediaControl,&IID_IMediaControl ＞pControl = m_pGraph;

hr = pControl-＞Run( );