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