DirectShow Filter 基礎(chǔ)與簡單的示例程序
DirectShow 是一個 Windows 平臺上的流媒體框架，提供了高質(zhì)量的多媒體流采集和回放功能。
Filter 實質(zhì)是一個 COM 組件，所以學(xué)習(xí)開發(fā) Filter 前你應(yīng)該對 COM 相關(guān)知識有點了解。COM 組件的實質(zhì)是實現(xiàn)了純虛指針接口的 C++ 對象。
應(yīng)用程序開發(fā)者只需要基本的 COM 組件知識：實例化COM組件、調(diào)用接口、管理接口的引用計數(shù)。Filter 開發(fā)者則需要更多。
選擇一個基類，聲明自己的類。
應(yīng)該清楚這個 Filter 在整個 Filter Graph 的位置，這個 Filter 的輸入是什么數(shù)據(jù)，輸出是什么數(shù)據(jù)，有幾個輸入 Pin、幾個輸出 Pin 等，可以畫出這個 Filter 的草圖。
Win7: DirectShow SDK 做為 Windows SDK(GRMSDK_EN_DVD.iso) 的一部分，不再有單獨的 DirectX SDK 包。
在 DirectShow 中，應(yīng)用程序要實現(xiàn)功能就必須將這些 Filter 鏈接在一起，因而一個 Filter 的輸出就變成了另一個 Filter 的輸入。這一系列串在一起的 Filter 稱為 Filter Graph。
使用 VS2008 建立 Filter 開發(fā)工程的過程如下：
(1) 新建?
Visual C++/Win32 項目，工程名如：FilterSample。點擊“確定”進(jìn)入下一步；
(2) 應(yīng)用程序類型選擇：DLL，一般不選擇 MFC 和 ATL；
工程的建立完成，編譯后可以先將輸入文件改名。方法如下：
屬性頁/鏈接器/常規(guī)/輸出文件，修改為：$(OutDir)/FilterSample.ax
DirectShow 必須用到以下頭文件的庫文件:
#include?"streams.h"
#include?"initguid.h"
strmbasd.lib
winmm.lib
uuid.lib
Quartz.lib???輸出?AMGetErrorText?函數(shù)，如果不調(diào)用此函數(shù)，此庫不是必需的。
FilterSample.def?文件的內(nèi)容:
LIBRARY?FilterSample.ax?
EXPORTS
;?需要定義的導(dǎo)出函數(shù)
DllMain?PRIVATE
DllRegisterServer?PRIVATE
DllUnregisterServer?PRIVATE
;?在基類中已經(jīng)定義的導(dǎo)出函數(shù)
DllGetClassObject?PRIVATE
DllCanUnloadNow?PRIVATE
dllmain.cpp?的代碼如下:
//?dllmain.cpp?:?定義?DLL?應(yīng)用程序的入口點。
#include?"stdafx.h"
#include?"streams.h"
//?BOOL?APIENTRY?DllMain(?HMODULE?hModule,
//????????????????????????DWORD??ul_reason_for_call,
//????????????????????????LPVOID?lpReserved
//???????????)
//?{
//??switch?(ul_reason_for_call)
//??{
//??case?DLL_PROCESS_ATTACH:
//??case?DLL_THREAD_ATTACH:
//??case?DLL_THREAD_DETACH:
//??case?DLL_PROCESS_DETACH:
//????break;
//??}
//??return?TRUE;
//?}
STDAPI?DllRegisterServer()
{
??return?AMovieDllRegisterServer2(TRUE);
}
STDAPI?DllUnregisterServer()
{
??return?AMovieDllRegisterServer2(FALSE);
}
extern?"C"?BOOL?WINAPI?DllEntryPoint(HINSTANCE,?ULONG,?LPVOID);
BOOL?APIENTRY?DllMain(HANDLE?hModule,?DWORD??dwReason,???LPVOID?lpReserved)
{
??return?DllEntryPoint((HINSTANCE)(hModule),?dwReason,?lpReserved);
}
編譯時，可能會遇到如下問題：
1>e:worksourcecodetestcodefiltersampledllmain.cpp(23) : error C3861: “AMovieDllRegisterServer2”: 找不到標(biāo)識符
1>e:worksourcecodetestcodefiltersampledllmain.cpp(27) : error C3861: “AMovieDllRegisterServer2”: 找不到標(biāo)識符
編譯錯誤, 一般是頭文件沒有包含。所以，包含: #include "streams.h"
1>dllmain.obj : error LNK2019: 無法解析的外部符號 _AMovieDllRegisterServer2@4，該符號在函數(shù) _DllRegisterServer@0 中被引用
1>dllmain.obj : error LNK2019: 無法解析的外部符號 _DllEntryPoint@12，該符號在函數(shù) _DllMain@12 中被引用
1>E:WorkSourceCodeTestCodeFilterSampleDebugFilterSample.dll : fatal error LNK1120: 2 個無法解析的外部命令
鏈接錯誤, 一般是庫文件沒有包含。所以，庫輸入中包含: strmbasd.lib
1>正在鏈接...
1>strmbasd.lib(wxdebug.obj) : error LNK2019: 無法解析的外部符號 __imp__timeGetTime@0，該符號在函數(shù) "void __stdcall DbgInitialise(struct HINSTANCE__ *)" (?DbgInitialise@@YGXPAUHINSTANCE__@@@Z) 中被引用
1>strmbasd.lib(wxutil.obj) : error LNK2001: 無法解析的外部符號 __imp__timeGetTime@0
1>strmbasd.lib(wxutil.obj) : error LNK2019: 無法解析的外部符號 __imp__timeSetEvent@20，該符號在函數(shù) "unsigned int __cdecl CompatibleTimeSetEvent(unsigned int,unsigned int,void (__stdcall*)(unsigned int,unsigned
int,unsigned long,unsigned long,unsigned long),unsigned long,unsigned int)" (?CompatibleTimeSetEvent@@YAIIIP6GXIIKKK@ZKI@Z) 中被引用
1>E:WorkSourceCodeTestCodeFilterSampleDebugFilterSample.dll : fatal error LNK1120: 4 個無法解析的外部命令
包含 ?winmm.lib, 可以解決 timeGetTime 鏈接錯誤的問題
增加頭文件 FilterSample.h，其內(nèi)容如下:
其中 GUID 的生成，需要用到下面的工具: Microsoft SDKsWindowsv7.1Binguidgen.exe
#ifndef?_FILTER_SAMPLE_H_
#define?_FILTER_SAMPLE_H_
//?{33B57142-BD07-4a77-AE91-A8F6C24A8F40}
DEFINE_GUID(CLSID_FilterSample,?
????0x33b57142,?0xbd07,?0x4a77,?0xae,?0x91,?0xa8,?0xf6,?0xc2,?0x4a,?0x8f,?0x40);
class?CFilterSample:?public?CCritSec,?public?CBaseFilter
{
public:
??CFilterSample(TCHAR?*pName,LPUNKNOWN?pUnk,HRESULT?*hr);
??virtual?~CFilterSample();?
??static?CUnknown?*?WINAPI?CreateInstance(LPUNKNOWN?pUnk,?HRESULT?*phr);?
??CBasePin?*GetPin(int?n);
??int?GetPinCount();??
};
#endif
FilterSample.cpp 的內(nèi)容如下:
//?FilterSample.cpp?:?定義?DLL?應(yīng)用程序的導(dǎo)出函數(shù)。
//
#include?"stdafx.h"
#include?"streams.h"
#include?"initguid.h"
#include?"FilterSample.h"
//?Using?this?pointer?in?constructor
#pragma?warning(disable:4355?4127)
//////////////////////////////////////////////////////////////////////////
//?AMOVIESETUP_FILTER?描述一個?Filter
//?AMOVIESETUP_PIN?描述?pin
//?AMOVIESETUP_MEDIATYPE?描述數(shù)據(jù)類型
const?AMOVIESETUP_MEDIATYPE?sudPinTypes?=
{
??&MEDIATYPE_NULL,?????????//?Major?CLSID
??&MEDIASUBTYPE_NULL???????//?Minor?type
};
const?AMOVIESETUP_PIN?psudPins[]?=
{
??{?
????L"Input",?????????????//?Pin's?string?name
????FALSE,????????????????//?Is?it?rendered
????FALSE,????????????????//?Is?it?an?output
????FALSE,????????????????//?Allowed?none
????FALSE,????????????????//?Allowed?many
????&CLSID_NULL,??????????//?Connects?to?filter
????L"Output",????????????//?Connects?to?pin
????1,????????????????????//?Number?of?types
????&sudPinTypes??????????//?Pin?information
??},
??{
????L"Output",????????????//?Pin's?string?name
????FALSE,????????????????//?Is?it?rendered
????TRUE,?????????????????//?Is?it?an?output
????FALSE,????????????????//?Allowed?none
????FALSE,????????????????//?Allowed?many
????&CLSID_NULL,??????????//?Connects?to?filter
????L"Input",?????????????//?Connects?to?pin
????1,????????????????????//?Number?of?types
????&sudPinTypes??????????//?Pin?information
??}
};
const?AMOVIESETUP_FILTER?sudInfTee?=
{
??&CLSID_FilterSample,???????????//?CLSID?of?filter
??L"Filter?Sample?Test?Lib",?????//?Filter's?name
??MERIT_DO_NOT_USE,??????????????//?Filter?merit
??2,?????????????????????????????//?Number?of?pins
??psudPins???????????????????????//?Pin?information
};
//////////////////////////////////////////////////////////////////////////
CFactoryTemplate?g_Templates[1]?=?
{
??{
????L"Filter?Sample",????????????????//?Name
????&CLSID_FilterSample,?????????????//?CLSID
????CFilterSample::CreateInstance,???//?Method?to?create?an?instance?of?MyComponent
????NULL,????????????????????????????//?Initialization?function
????&sudInfTee???????????????????????//?Set-up?information?(for?filters)
??}
};
int?g_cTemplates?=?sizeof(g_Templates)?/?sizeof(g_Templates[0]);
CFilterSample::CFilterSample(TCHAR?*pName,LPUNKNOWN?pUnk,HRESULT?*hr)
??:CBaseFilter(NAME("Filter?Sample"),?pUnk,?this,?CLSID_FilterSample)
{
}
CFilterSample::~CFilterSample()
{
}?
CBasePin?*?CFilterSample::GetPin(int?n)
{
??return?NULL;
}
int?CFilterSample::GetPinCount()
{
??return?0;
}
CUnknown?*?WINAPI?CFilterSample::CreateInstance(LPUNKNOWN?pUnk,?HRESULT?*pHr)
{
??CFilterSample?*pFilter?=?new?CFilterSample(NAME("Filter?Sample"),?pUnk,?pHr);
??if?(pFilter==?NULL)
??{
????*pHr?=?E_OUTOFMEMORY;
??}
??return?pFilter;
}
編譯時，可能遇到如下問題:
1>FilterSample.obj : error LNK2019: 無法解析的外部符號 "public: __thiscall CBaseFilter::CBaseFilter(wchar_t const *,struct IUnknown *,class CCritSec *,struct _GUID const &)" (??0CBaseFilter@@QAE@PB_WPAUIUnknown@@PAVCCritSec@@ABU_GUID@@@Z)，該符號在函數(shù)
"public: __thiscall CFilterSample::CFilterSample(wchar_t *,struct IUnknown *,long *)" (??0CFilterSample@@QAE@PA_WPAUIUnknown@@PAJ@Z) 中被引用
1>E:WorkSourceCodeTestCodeFilterSampleDebugFilterSample.dll : fatal error LNK1120: 1 個無法解析的外部命令
解決方法: 屬性頁 常規(guī)->字符集 修改為“使用多字節(jié)字符集”
編譯通過后，如何驗證此 Filter 呢？
regsvr32 FilterSample.ax
regsvr32 提示錯誤:
模塊“FilterSample.ax”已加載，但找不到入口點 DllRegisterServer。
請確?！癋ilterSample.ax”為有效的 DLL 或 OCX 文件，然后重試。
出現(xiàn)此錯誤的原因，是 FilterSample.def 未鏈接到工程中。在工程屬性頁，“鏈接器”/“輸入”/“模塊定義文件” 中輸入: FilterSample.def 后，重新編譯。
然后在命令行執(zhí)行: regsvr32 FilterSample.ax，則提示成功。
如何確認(rèn)成功了呢？可通過 Microsoft SDKsWindowsv7.1Bingraphedt.exe 來查看。方法如下：
點擊 graphedt.exe 的 Graph 菜單，選擇 Insert Filters...。在彈出的對話框: Which filters do you want to insert? 中，選擇 Directshow Filters/Filter Sample Test Lib。
這個名字看起來是不是很熟悉？看看上面的代碼中是不是有這樣的字符串，呵呵...。如果還不確認(rèn)，請看 Filter Sample Test Lib 的 GUID 和 文件名分別是:
@device:sw:{083863F1-70DE-11D0-BD40-00A0C911CE86}{33B57142-BD07-4A77-AE91-A8F6C24A8F40} 和 E:FiltersFilterSample.ax(具體的目錄與執(zhí)行 regsvr32 時 FilterSample.ax 所在的路徑相關(guān))。
下載文檔
