DirectShow - How To Play a File(Windows)

原文：http://msdn.microsoft.com/en-us/library/windows/desktop/dd389098(v=vs.85).aspx

本文尝试给你一个DirectShow的编程体验。它呈现出一个简单可以播放音乐和视频文件的控制台程序。虽然整个程序只有简单的几行，但是它演示了DirectShow的强大。

就像文章 Introduction to DirectShow Application Programming所描述的，一个DirectShow应用程序总是会执行相同的基本步骤：

1、创建Filter Graph Manager实例。

2、使用这个Manager去建立一个filter graph。

3、运行graph，让数据流通过所有的filter。

要编译和链接本文的代码，需要包含头文件Dshow.h 和 链接静态库 strmiid.lib，如需详细内容，请看Building DirectShow Applications.

首先，调用CoInitialize初始化com库。

HRESULT hr = CoInitialize(NULL);
if (FAILED(hr))
{
    // Add error-handling code here. (Omitted for clarity.)
}

记住自己编写代码的时候总是要去检查HRESULT的返回值，为了描述简单，下面的代码就不检查返回值了。

接下来，调用CoCreateInstance创建Filter Graph Manager:

IGraphBuilder *pGraph;
HRESULT hr = CoCreateInstance(CLSID_FilterGraph, NULL, 
    CLSCTX_INPROC_SERVER, IID_IGraphBuilder, (void **)&pGraph);

第一个参数是类标识符：填写  CLSID_FilterGraph

因为Filter Graph Manager是进程中的Dll，第三个参数用CLSCTX_INPROC_SERVER

DirectShow 也支持多线程，所以也可以指定参数 COINIT_MULTITHREADED调用CoInitializeEx

调用CoCreateInstance返回IGraphBuilder接口，内部有很多方法可以用来建立filter graph。

在这个示例中还要用到以下两个接口：

IMediaControl用来控制视频流，它里面有停止和运行graph的方法。

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);

现在你可以建立filter graph了，要播放文件，只要调用下面的方法即可：

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

IGraphBuilder::RenderFile建立filter graph来播放文件，第一个参数是文件名称，一定要是宽字符的字符串；第二个参数保留，而且必须为NULL。

当文件不存在或者这个格式不认识的话这个方法会失败。

假设这个方法调用成功，filter graph就可以开始播放了。

要run the graph，调用 IMediaControl::Run方法“

hr = pControl->Run();

当graph开始run的时候，数据就流过所有的filter，展现为视频或者音频。播放使用的是一个单独的线程，我们可以等待它播放完毕，使用IMediaEvent::WaitForCompletion 方法：

long evCode = 0;
pEvent->WaitForCompletion(INFINITE, &evCode);

这个方法的含义是等待，直到文件播放完毕或者设定的时间（第一个参数）用完。第一个参数设置了INFINITE，那么就是说要等文件播放完毕。

当程序运行结束，释放接口指针，关闭COM库。

pControl->Release();
pEvent->Release();
pGraph->Release();
CoUninitialize();

完整的代码如下：

#include <dshow.h>
void main(void)
{
    IGraphBuilder *pGraph = NULL;
    IMediaControl *pControl = NULL;
    IMediaEvent   *pEvent = NULL;

    // Initialize the COM library.
    HRESULT hr = CoInitialize(NULL);
    if (FAILED(hr))
    {
        printf("ERROR - Could not initialize COM library");
        return;
    }

    // Create the filter graph manager and query for interfaces.
    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;
    }

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

    // Build the graph. IMPORTANT: Change this string to a file on your system.
    hr = pGraph->RenderFile(L"C:\\Example.avi", NULL);
    if (SUCCEEDED(hr))
    {
        // Run the graph.
        hr = pControl->Run();
        if (SUCCEEDED(hr))
        {
            // Wait for completion.
            long evCode;
            pEvent->WaitForCompletion(INFINITE, &evCode);

            // Note: Do not use INFINITE in a real application, because it
            // can block indefinitely.
        }
    }
    pControl->Release();
    pEvent->Release();
    pGraph->Release();
    CoUninitialize();
}