directshow 入门——播放文件

这里提供一个控制台 应用程序去播放一个音、视频文件。这个程序只有几行长。

在前面介绍了一个基 于 DirectShow 的应用程序，必须要进行如下几个基本步骤：

1. 建立一个 Filter Graph Manager 的实例 .

2. 使用 Filter Graph Manager 建立一个 filter graph.

3. 运行这个 graph 。

 

调用 CoInitialize 去初始化一个这个 COM 库。

HRESULT hr = CoInitialize(NULL);

if (FAILED(hr))

{

    // 在这里加入错误处理

}

 

这里，我们跳过了对 返回值的检查，当你调用了任何方法的时候都应该对返回值进行检查。下面调用 CoCreateInstance创建 Filter Graph Manager 。

IGraphBuilder *pGraph;

HRESULT hr = CoCreateInstance(CLSID_FilterGraph, NULL,

    CLSCTX_INPROC_SERVER, IID_IGraphBuilder, (void **)&pGraph);

类 ID 是 CLSID_FilterGraph ， 由于 Filter Graph Manager 是动态链接库提供（ dll ），所以使用 CLSCTX_INPROC_SERVER 。

 

CoCreateInstance 将返 回 IgraphBuilder 接口，在该例子中还需要两个接口：

l         IMediaControl 用于控制数据流。它提供停止和开始的操作方法。

l         IMediaEvent   可以获得 Filter Graph Manager 事件。例如，可以获得播放完成事件。

 

这两个接口都由 Filter Graph Manager 提供，可以通过 IgraphBuilder 指针去获得它们：

 

IMediaControl *pControl;

 

IMediaEvent   *pEvent;

 

hr = pGraph->QueryInterface(IID_IMediaControl, (void **)&pControl);

 

hr = pGraph->QueryInterface(IID_IMediaEvent, (void **)&pEvent);

 

现在，你可以建立过 滤器图表 (Fileter Graph) 。对于文件播放，这里只需要调用一个方法就可 以了：

 

hr = pGraph->RenderFile(L"C://Example.avi", NULL);

 

IGraphBuilder::RenderFile 方法将建立一个过滤器图表，通过它来播放指定的文件。第一个参数指定要播放的文件名称，它是个宽字符字符串。第二个参数是系统保留，必须为 NULL 。如果指定文件不存在或文件格式未知，那么该方法调用将失败。

 

现在过滤器图表已经 准备好了去播放文件，但是还必须调用 IMediaControl::Run 方法去播放。

 

hr = pControl->Run();

 

当过滤器图表开始运 行，数据从通过过滤器播放出来。播放动作将在一个独立的线程中进行。调用 IMediaEvent::WaitForCompletion 方法可以等待文件播放完成。

 

long evCode = 0;

 

pEvent->WaitForCompletion(INFINITE, &evCode);

 

这个方法将一直等待 文件播放结束才返回。 INFINITE 就表示不能确定文件的播放时间长度。当应用程序完成播放后，应该释放掉接口指针和关闭 COM 库。

 

pControl->Release();

 

pEvent->Release();

 

pGraph->Release();

 

CoUninitialize();

 

 

3.2. 全部源码如下 :

// ControlTest.cpp : 定义控制台应用程序的入口点。

// 该HelloWord 的作用主要是提供一个控制台应用程序去播放一个音、视频文件。

 

#include "stdafx.h"

#include <dshow.h>

int _tmain (int argc , _TCHAR * argv [])

{

 

     IGraphBuilder *pGraph = NULL ;

     IMediaControl *pControl = NULL ;

     IMediaEvent    *pEvent = NULL ;

     // 初始化COM 库

     HRESULT hr = CoInitialize (NULL );

 

     if (FAILED (hr ))

     {

         printf ("ERROR - Could not initialize COM library");

         return 0;

 

     }

     // 建立过滤器图表管理器

     hr = CoCreateInstance (CLSID_FilterGraph , NULL , CLSCTX_INPROC_SERVER ,

 

         IID_IGraphBuilder , (void **)&pGraph );

 

     if (FAILED (hr ))

     {

         printf ("ERROR - Could not create the Filter Graph Manager.");

         return 0;

     }

 

     hr = pGraph ->QueryInterface (IID_IMediaControl , (void **)&pControl );

     hr = pGraph ->QueryInterface (IID_IMediaEvent , (void **)&pEvent );

     // 建立过滤器图表

     hr = pGraph ->RenderFile (L "C://Example.avi", NULL );

     if (SUCCEEDED (hr ))

     {

         // 播放

         hr = pControl ->Run ();

         if (SUCCEEDED (hr ))

         {

              // 等待播放结束

              long evCode ;

              pEvent ->WaitForCompletion (INFINITE , &evCode );

         }

     }

     pControl ->Release ();

     pEvent ->Release ();

     pGraph ->Release ();

     CoUninitialize ();

     return 0;

}