如何播放檔案
[與此頁面相關聯的功能，DirectShow是舊版功能。 它已被 MediaPlayer、IMFMediaEngine以及媒體基礎架構中的 音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft強烈建議新程式代碼盡可能在媒體 基礎中使用 MediaPlayer、IMFMediaEngine 和 音訊/視訊擷取，而不是 DirectShow。 Microsoft建議使用舊版 API 的現有程式代碼，盡可能改寫成使用新的 API。]
本文旨在讓您初步了解 DirectShow 程式設計。 它提供播放音訊或視訊檔案的簡單控制台應用程式。 程式只有幾行長，但它示範 DirectShow 程式設計的某些功能。
如 DirectShow 應用程式程式設計 簡介 一文所述，DirectShow 應用程式一律會執行相同的基本步驟：
- 建立 Filter Graph Manager實例。
- 使用 Filter Graph Manager 來建置篩選圖表。
- 運行圖表，使得數據流經篩選器。
若要編譯並連結本主題中的程序代碼，請包含頭檔 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 Manager 取得事件的方法。 在此範例中，介面是用來等候播放完成。
這兩個介面都會由 Filter Graph Manager 公開。 使用傳回 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();
}
相關主題