一 環境設置
二 DirectShow編程簡介
三 播放文件例程
一 環境設置
該節介紹如何建立DirectShow應用程序。你可以建立一個控制檯程序,或者Visual Studio環境下的其它Visual C++的項目。
頭文件
所有DirectShow 程序都使用下表中的頭文件。
頭文件
|
需 要
|
dshow.h |
所有DirectShow 程序。 |
有些DirectShow接口會要求其他頭文件,你可以去查看這些接口的參考手冊。
庫文件
DirectShow程序要使用的庫文件如下:
庫文件
|
說 明 |
Strmiids.lib |
提供類標識(CLSIDs)和接口表示(IIDs)。所有的DirectShow程序都要求使用該庫文件。 |
Quartz.lib |
提供AMGetErrorText函數,如果你不調用這個函數,就可以不加載該庫文件。
|
可以把DirectX SDK 的Include 和Lib目錄放在Visual Studio的搜索路徑的第一位。以確保你可以使用最新的版本!
二 DirectShow編程簡介
該節對DirectShow編程的基本術語和概念進行介紹,通過對該節的閱讀,你可以寫你的一個DirectShow應用程序。
過濾器(Filters)和過濾器圖表(Filter Graphs)
過濾器(Filters)就是一個軟件組件,它執行一些針對多媒體流的操作。比如:
· 讀入文件
· 從視頻捕獲設備得到視頻
· 對多種流格式解碼,如MPEG-1
· 傳送數據到顯卡和聲卡
過濾器可以接收輸入並提供輸出,比如,一個MPEG-1視頻解碼過濾器,它接收MPEG編碼的數據流,通過處理後輸出非壓縮的視頻圖像幀。
在DirectShow, 應用程序執行的一些工作是在一串過濾器鏈接中完成,可能某個過濾器的輸出到了下一步就是另一個過濾器的輸入。這一組連接,我們就稱爲過濾器圖表。
例如下圖顯示了一個播放AVI文件的過濾器圖表。
File Source 過濾器從硬盤上讀取AVI文件。AVI Splitter 過濾器把文件解析爲兩個數據流(壓縮的視頻流和音頻流)。AVI Decompressor過濾器對視頻流解碼,Video Rendere把視頻數據顯示出來(通過DirectDraw 或 GDI)。Default DirectSound Device過濾器使用DirectSound播發音頻數據
應用程序不需要對數據流動進行管理,這些過濾器被級別更高的組件控制,過濾器圖表管理器(Filter Graph Manager)管理這些過濾器。這樣,你就可以使用更高級別的API來控制(比如”Run” , ”Stop”),如果你要控制流的操作,你也可以通過直接使用過濾器的COM接口實現。過濾器圖表管理器通過事件來通知應用程序。
過濾器圖表管理器的另一個用途是:它通過把過濾器連接在一起,嚮應用程序提供了建立過濾器圖表的方法。
編寫DirectShow 程序
在大部分的情況下,DirectShow應用程序必須執行下面3個步驟:
- 應用程序建立一個Filter Graph Manager的實例。
- 應用程序使用Filter Graph Manager 去建立一個filter graph. Filter graph中的過濾器依賴與應用程序的需求。
- 應用程序使用Filter Graph Manager 去控制filter graph 並通過過濾器去對數據解析分流。在整個處理過程中,應用程序都將響應Filter Graph Manager的事件。
當處理完成後,應用程序將釋放掉Filter Graph Manager和所有的過濾器。
DirectShow 是基於COM的。Filter Graph Manager 和過濾器都是COM對象。你應該對COM編程有全面的瞭解。
三 播放文件例程
這裏提供一個控制檯應用程序去播放一個音、視頻文件。這個程序只有幾行長。
在前面介紹了一個基於DirectShow的應用程序,必須要進行如下幾個基本步驟:
- 建立一個Filter Graph Manager的實例.
- 使用Filter Graph Manager 建立一個filter graph.
- 運行這個graph。
調用CoInitialize 去初始化一個這個COM 庫。
HRESULT hr = CoInitialize(NULL);
if (FAILED(hr))
{
// 在這裏加入錯誤處理
}
這裏,我們跳過了對返回值的檢查,當你調用了任何方法的時候都應該對返回值進行檢查。下面調用CoCreateInstance創建Filter Graph Manager。
IGraphBuilder *pGraph;
HRESULT hr = CoCreateInstance(CLSID_FilterGraph, NULL,
CLSCTX_INPROC_SERVER, IID_IGraphBuilder, (void **)&pGraph);
類ID是CLSID_FilterGraph,由於Filter Graph Manager是動態鏈接庫提供(dll),所以使用CLSCTX_INPROC_SERVER。
CoCreateInstance 將返回IgraphBuilder接口,在該例子中還需要兩個接口:
l IMediaControl 用於控制數據流。它提供停止和開始的操作方法。
l 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);
現在,你可以建立過濾器圖表(Fileter Graph)。對於文件播放,這裏只需要調用一個方法就可以了:
hr = pGraph->RenderFile(L"C://Example.avi", NULL);
IGraphBuilder::RenderFile方法將建立一個過濾器圖表,通過它來播放指定的文件。第一個參數指定要播放的文件名稱,它是個寬字符字符串。第二個參數是系統保留,必須爲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;
// 初始化COM 庫
HRESULT hr = CoInitialize(NULL);
if (FAILED(hr))
{
printf("ERROR - Could not initialize COM library");
return;
}
// 建立過濾器圖表管理器
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);
// 建立過濾器圖表
hr = pGraph->RenderFile(L"C://Example.avi", NULL);
if (SUCCEEDED(hr))
{
// 播放
hr = pControl->Run();
if (SUCCEEDED(hr))
{
// 等待播放結束
long evCode;
pEvent->WaitForCompletion(INFINITE, &evCode);
}
}
pControl->Release();
pEvent->Release();
pGraph->Release();
CoUninitialize();
}v