DirectShow 播放音视频文件

   一个DirectShow应用程序总是执行相同的基本步骤：

1. 创建一个Filter Graph Manager的示例；
2. 使用Filter Graph Manager来构建Filter graph;
3. 运行Graph，使数据通过Filter流动；

   在编译之前，请包含头文件Dshow.h并链接到静态库文件strmiids.lib.

 

   首先调用CoInitialize或CoInitializeEx来初始化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)为CLSID_FilterGraph。Filter Graph Manager由一个进程内DLL提供，因此执行上下文是CLSCTX_INPROC_SERVER。DirectShow支持免费线程模型，因此你也可以使用COINT_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。第一个参数是文件名，用宽字符(2字节)字符串表示。第二个参数是保留的，必须等于NULL。

    如果指定的文件不存在，或者文件格式无法识别，则此方法调用使用。然后，假设该方法成功，Filter Graph就可以播放了。要运行Graph，需要调用IMediaControl::Run()方法。

hr = pControl->Run();

    当Filter Graph 运行，数据通过Filter呈现为视频和音频。播放发生在单独的线程上，可以通过调用IMediaEvent::WaitForCompletion方法等待播放完成：

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

    此方法将阻塞，直到文件播放完毕，或者直到超过指定的超时间隔。之INFINITE意味着应用程序无限期的阻止，直到文件播放完成。

    当应用程序完成时，释放接口指针并关闭COM库：

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

 

完整示例代码

#include 
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();
}

参考：

https://www.yuque.com/docs/share/086f95ce-1d82-4098-8adc-061c675aa9b5