Share via

如何播放檔案

  • 發行項

[與此頁面 相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]

本文旨在為您提供 DirectShow 程式設計的類別。 它提供播放音訊或視訊檔案的簡單主控台應用程式。 程式只有幾行長，但它示範一些 DirectShow 程式設計的強大功能。

如 DirectShow 應用程式程式設計簡介 一文所述，DirectShow 應用程式一律會執行相同的基本步驟：

  1. 建立 Filter Graph Manager的實例。
  2. 使用 Filter Graph 管理員來建置篩選圖形。
  3. 執行圖形，導致資料在篩選準則中移動。

若要編譯並連結本主題中的程式碼，請包含標頭檔 Dshow.h，並連結至靜態程式庫檔案 strmiids.lib。 如需詳細資訊，請參閱 建置 DirectShow 應用程式。

首先，呼叫 CoInitialize 或 CoInitializeEx 來初始化 COM 程式庫：

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

為了簡單起見，此範例會忽略傳回值，但您應該一律檢查任何方法呼叫中的 HRESULT 值。

接下來，呼叫 CoCreateInstance 以建立 Filter Graph 管理員：

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

如前所示，CLSID) (類別識別碼CLSID_FilterGraph。 Filter Graph 管理員是由進程內 DLL 所提供，因此執行內容 會CLSCTX_INPROC_SERVER。 DirectShow 支援自由執行緒模型，因此您也可以使用COINIT_MULTITHREADED旗標呼叫CoInitializeEx。

呼叫 CoCreateInstance會傳回IGraphBuilder介面，其中大部分包含用來建置篩選圖形的方法。 此範例需要另外兩個介面：

  • IMediaControl 控制項串流。 它包含停止和啟動圖形的方法。
  • IMediaEvent 有從 Filter Graph 管理員取得事件的方法。 在此範例中，介面用來等候播放完成。

這兩個介面都是由篩選圖形管理員公開。 使用傳回的 IGraphBuilder 指標來查詢它們：

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

現在您可以建置篩選圖表。 針對檔案播放，這是透過單一方法呼叫來完成：

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

IGraphBuilder：：RenderFile方法會建置可播放指定檔案的篩選圖形。 第一個參數是檔案名，以寬字元表示 (2 位元組) 字串。 第二個參數是保留的，而且必須等於 Null。

如果指定的檔案不存在，或無法辨識檔案格式，這個方法可能會失敗。 不過，假設方法成功，篩選圖形現在已準備好播放。 若要執行圖形，請呼叫 IMediaControl：：Run 方法：

hr = pControl->Run();

當篩選圖形執行時，資料會透過篩選移動，並轉譯為視訊和音訊。 播放會在個別的執行緒上發生。 您可以呼叫 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();
}

基本 DirectShow 工作