如何播放檔案
[與此頁面 相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]
本文旨在為您提供 DirectShow 程式設計的類別。 它提供播放音訊或視訊檔案的簡單主控台應用程式。 程式只有幾行長，但它示範一些 DirectShow 程式設計的強大功能。
如 DirectShow 應用程式程式設計簡介 一文所述，DirectShow 應用程式一律會執行相同的基本步驟：
- 建立 Filter Graph Manager的實例。
- 使用 Filter Graph 管理員來建置篩選圖形。
- 執行圖形，導致資料在篩選準則中移動。
若要編譯並連結本主題中的程式碼，請包含標頭檔 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();
}
相關主題