Directshow 注册 source filter
编写source filter最初需要接触的就是 filter的register和unregister，涉及到的函数有两个
DllRegisterServer()
以及
DllUnregisterServer()
在这两个函数中，完成了filter的register和unregister
而其中真正的注册，又是通过IFilterMapper2::RegisterFilter() 和 IFilterMapper2::UnregisterFilter()
来实现的。
我们需要在注册时将Filter放入不同的category，譬如 video capture source / directshow filters （使用GraphEdit可以看到，不同的category下的filters）。注册在video capture source下的filter可以在AMCapture / QQ 等AP，搜索video capture source filters出现。
- STDAPI DllRegisterServer()
- {
- // return AMovieDllRegisterServer2(TRUE);
- HRESULT hr;
- IFilterMapper2 *pFM2 = NULL;
- hr = AMovieDllRegisterServer2(TRUE);
- if (FAILED(hr))
- {
- return hr;
- }
- hr = CoCreateInstance(CLSID_FilterMapper2, NULL, CLSCTX_INPROC_SERVER, IID_IFilterMapper2, (void**)&pFM2);
- if (FAILED(hr))
- {
- return hr;
- }
- hr = pFM2->RegisterFilter(CLSID_UVCPreview, L"UVC preview", NULL, &CLSID_VideoInputDeviceCategory, L"UVC preview", &rf2FilterReg);
- pFM2->Release();
- return hr;
- } // DllRegisterServer
- //
- // DllUnregisterServer
- //
- STDAPI DllUnregisterServer()
- {
- // return AMovieDllRegisterServer2(FALSE);
- 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_VideoInputDeviceCategory, L"UVC preview", CLSID_UVCPreview);
- pFM2->Release();
- return hr;
- } // DllUnregisterServer
其中 IFilterMapper2::RegisterFilter()参数：
- HRESULT RegisterFilter(
- REFCLSID clsidFilter,
- LPCWSTR Name,
- IMoniker **ppMoniker,
- const CLSID *pclsidCategory,
- const OLECHAR *szInstance,
- const REGFILTER2 *prf2
- );
- Parameters
- clsidFilter
- [in] Class identifier (CLSID) of the filter.
- Name
- [in] Descriptive name for the filter.
- ppMoniker
- [in, out] Address of a pointer to a device moniker that determines where this filter's data will be written. Can be NULL.
- pclsidCategory
- [in] Pointer to the filter category of the filter. If NULL, the default category is CLSID_ActiveMovieFilters. (See Filter Categories.)
- szInstance
- [in] Instance data for constructing the device moniker's display name. Can be the friendly name, or the string representation of the filter CLSID. If NULL, defaults to the filter CLSID.
- prf2
- [in] Pointer to a REGFILTER2 structure containing filter information.
- Return Values
- Returns an HRESULT value. Possible values include those shown in the following table.
- Value Description
- S_OK Success.
- VFW_E_BAD_KEY Could not get registry key.
而Category主要包括：
- The following categories are defined in Uuids.h. They are defiined when you include Dshow.h.
- Friendly Name CLSID Merit
- Audio Capture Sources CLSID_AudioInputDeviceCategory MERIT_DO_NOT_USE
- Audio Compressors CLSID_AudioCompressorCategory MERIT_DO_NOT_USE
- Audio Renderers CLSID_AudioRendererCategory MERIT_NORMAL
- Device Control Filters CLSID_DeviceControlCategory MERIT_DO_NOT_USE
- DirectShow Filters CLSID_LegacyAmFilterCategory MERIT_NORMAL
- External Renderers CLSID_TransmitCategory MERIT_DO_NOT_USE
- Midi Renderers CLSID_MidiRendererCategory MERIT_NORMAL
- Video Capture Sources CLSID_VideoInputDeviceCategory MERIT_DO_NOT_USE
- Video Compressors CLSID_VideoCompressorCategory MERIT_DO_NOT_USE
- Video Effects (1 input) CLSID_VideoEffects1Category MERIT_DO_NOT_USE
- Video Effects (2 inputs) CLSID_VideoEffects2Category MERIT_DO_NOT_USE
- WDM Streaming Capture Devices AM_KSCATEGORY_CAPTURE MERIT_DO_NOT_USE
- WDM Streaming Crossbar Devices AM_KSCATEGORY_CROSSBAR MERIT_DO_NOT_USE
- WDM Streaming Rendering Devices AM_KSCATEGORY_RENDER MERIT_DO_NOT_USE
- WDM Streaming Tee/Splitter Devices AM_KSCATEGORY_SPLITTER MERIT_DO_NOT_USE
- WDM Streaming TV Audio Devices AM_KSCATEGORY_TVAUDIO MERIT_DO_NOT_USE
- WDM Streaming TV Tuner Devices AM_KSCATEGORY_TVTUNER MERIT_DO_NOT_USE
- WDM Streaming VBI Codecs AM_KSCATEGORY_VBICODEC MERIT_DO_NOT_USE
- ActiveMovie Filter Categories CLSID_ActiveMovieCategories Not applicable
- The following categories are defined in the header file Ks.h:
- Friendly Name CLSID Merit
- WDM Streaming Communication Transforms KSCATEGORY_COMMUNICATIONSTRANSFORM MERIT_DO_NOT_USE
- WDM Streaming Data Transforms KSCATEGORY_DATATRANSFORM MERIT_DO_NOT_USE
- WDM Streaming Interface Transforms KSCATEGORY_INTERFACETRANSFORM MERIT_DO_NOT_USE
- WDM Streaming Mixer Devices KSCATEGORY_MIXER MERIT_DO_NOT_USE
- The following categories are defined in the header file Ksmedia.h. Include these header files, in the order listed:
- #include <ks.h>
- #include <ksmedia.h>
- Friendly Name CLSID Merit
- WDM Streaming System Audio Devices KSCATEGORY_AUDIO_DEVICE MERIT_DO_NOT_USE
- The following categories are defined in the header file Bdamedia.h. Include these header files, in the order listed:
- #include <ks.h>
- #include <ksmedia.h>
- #include <bdamedia.h>
- Friendly Name CLSID Merit
- BDA CP/CA Filters Category CLSID_CPCAFiltersCategory MERIT_NORMAL
- BDA Network Providers KSCATEGORY_BDA_NETWORK_PROVIDER MERIT_NORMAL
- BDA Receiver Components KSCATEGORY_BDA_RECEIVER_COMPONENT MERIT_NORMAL
- BDA Rendering Filters KSCATEGORY_IP_SINK MERIT_DO_NOT_USE
- BDA Source Filters KSCATEGORY_BDA_NETWORK_TUNER MERIT_DO_NOT_USE
- BDA Transport Information Renderers KSCATEGORY_BDA_TRANSPORT_INFORMATION MERIT_NORMAL
其中：
CLSID_VideoInputDeviceCategory， 注册到此category后，filter会出现在video capture source category下，被AMCapture / QQ等AP搜索到。
CLSID_LegacyAmFilterCategory， 注册到此category后，filter会出现在 directshow filters category，大部分的filter注册在此category。
需要注意的是 register / unregister 必须在同一个category， 使用同一 REFCLSID， 否则会出现register error。
譬如：
0x80070002 ： register / unregister 未在同一个 category
0x80070005 ： register / unregister 权限不够 （vista下权限管理，需要在administor下register/unregister filter）
