註冊DirectShow Filter信息

編寫自己的DirectShow Filter，除了編寫實現功能的代碼之外，要使自己的DLL稱爲一個Filter，還有一個重要的工作需要做，那就是註冊信息。DirectShow Filter有兩種信息註冊，一種是包含Filter的DLL作爲COM組件的註冊信息，一種是註冊Filter種類信息。

當應用程序通過CoCreateInstane創建Filter的時候，通過第一中註冊信息定位DLL。

第二種信息註冊後，可以通過系統設備枚舉器和Filter Mapped定位到Filter，這種信息不是必須註冊，當不註冊時候，Filter被默認爲CLSID_LegacyAmFilterCategory類型。

註冊Filter種類信息分一下步驟：

一、聲明Filter信息

 

AMOVIESETUP_MEDIATYPE、AMOVIESETUP_PIN、AMOVIESETUP_FILTER 1．AMOVIESETUP_MEDIATYPE typedef struct { const CLSID *clsMajorType;//主媒體類型 const CLSID *clsMinorType;//子媒體類型，可以使用MEDIASUBTYPE_NULL } REGPINTYPES; typedef REGPINTYPES AMOVIESETUP_MEDIATYPE, * PAMOVIESETUP_MEDIATYPE, * LPAMOVIESETUP_MEDIATYPE; 2．AMOVIESETUP_PIN typedef struct { LPWSTR strName;//已經廢棄，可以填充Output或者是Input，表示pin的類型 BOOL bRendered;//TRUE表示這是Render的Input Pin，其他的都使用FALSE BOOL bOutput;//TRUE表示這是output Pin。 BOOL bZero;//TRUE表示Filter可以包含0個這個pin的實例。 BOOL bMany;//TRUE表示Filter可以包含兩個或以上的這個pin的實例。 const CLSID *clsConnectsToFilter;//已經廢棄，填充CLSID_NULL const WCHAR *strConnectsToPin;//已經廢棄，填充NULL UINT nMediaTypes;//pin能支持多少中媒體類型 const REGPINTYPES *lpMediaType;// AMOVIESETUP_MEDIATYPE對象，描述媒體類型 } REGFILTERPINS; typedef REGFILTERPINS AMOVIESETUP_PIN, * PAMOVIESETUP_PIN, * LPAMOVIESETUP_PIN; 3．AMOVIESETUP_FILTER typedef struct _AMOVIESETUP_FILTER { const CLSID *clsID;//Filter的CLASSID const WCHAR *strName;//Filter的名字 DWORD dwMerit;// UINT nPins;//lpPin中AMOVIESETUP_PIN對象的個數 const AMOVIESETUP_PIN *lpPin;// AMOVIESETUP_PIN對象指針 } AMOVIESETUP_FILTER, * PAMOVIESETUP_FILTER, * FAR LPAMOVIESETUP_FILTER;

 

 

二、聲明類工廠

 

 

CFactoryTemplate g_Templates[] = { { L"MyFilter"//Filter名字 , &CLSID_MyFilter//Filter的CLASSID , CMySourceFilter::CreateInstance//Filter的實例化接口 , NULL , &sudBallax }// AMOVIESETUP_FILTER對象 }; int g_cTemplates = sizeof(g_Templates) / sizeof(g_Templates[0]);

 

 

三、重載DllRegisterServer

 

REGFILTER2 rf2FilterReg = { 1, // Pin使用AMOVIESETUP_PIN，所以版本爲1 MERIT_NORMAL, // Merit. 1, // Number of pins. &sudPins // Pointer to pin information. }; STDAPI DllRegisterServer(void) { HRESULT hr; IFilterMapper2 *pFM2 = NULL; //此處註冊DLL信息 hr = AMovieDllRegisterServer2(TRUE); if (FAILED(hr)) return hr; //以下注冊Filter信息 hr = CoCreateInstance(CLSID_FilterMapper2, NULL, CLSCTX_INPROC_SERVER, IID_IFilterMapper2, (void **)&pFM2); if (FAILED(hr)) return hr; hr = pFM2->RegisterFilter( CLSID_SomeFilter, // Filter CLSID. g_wszName, // Filter name. NULL, // Device moniker. &CLSID_VideoCompressorCategory, // Video compressor category. g_wszName, // Instance data. &rf2FilterReg // Pointer to filter information. ); pFM2->Release(); return hr; }

 

 

 

四、註銷Filter的函數

STDAPI DllUnregisterServer() { HRESULT hr; IFilterMapper2 *pFM2 = NULL; hr = AMovieDllRegisterServer2(FALSE); if (FAILED(hr)) return hr; hr = CoCreateInstance(CLSID_FilterMapper2, NULL, CLSCTX_INPROC_SERVER, IID_IFilterMapper2, (void **)&pFM2); if (FAILED(hr)) return hr; hr = pFM2->UnregisterFilter(&CLSID_VideoCompressorCategory, g_wszName, CLSID_SomeFilter); pFM2->Release(); return hr; }

IFilterMapper2的RegisterFilter接口註冊Filter信息，接口的第四個參數決定Filter屬於什麼種類，如果使用CLSID_VideoCompressorCategory，在GraphEdit中看到的Filter就在Video Capture Source中。