DirectShow 学习(一) 基础和BaseClasses部分源代码浅读

1. BaseClasses中实现COM的部分源代码分析[combase.h/combase.cpp]
   • classCBaseObject是BaseClasses中的基类，它只维护一个m_cObjects的计数信息。同时它只支持输入名称的Constructor。
   • CUnknown是实现了COM的基类，它从INonDelegationUnknown接口继承支持Aggregation。同时它使用Member作为Delegation Unknown接口：
     constLPUNKNOWNm_pUnknown;
     同时它维护了COM的Reference Count-volatileLONG m_cRef;
     它的Constructor为：
     CUnknown(constTCHAR *pName, LPUNKNOWN pUnk);
     CUnknown(TCHAR *pName, LPUNKNOWN pUnk,HRESULT *phr);
     当然Unicode版本还要多两个支持CHAR类型的Constructor.
   • 类厂模板定义（真正写DirectShow可能用不到该模板，主要是它自己的实现，下面将会见到）：
     classCFactoryTemplate{
     public:
     constWCHAR * m_Name;// 名称
     constCLSID * m_ClsID;// CLSID
     LPFNNewCOMObject m_lpfnNew;// 真正的Create函数
     LPFNInitRoutine m_lpfnInit;
     constAMOVIESETUP_FILTER * m_pAMovieSetup_Filter;
     BOOL IsClassID(REFCLSID rclsid)const{return(IsEqualCLSID(*m_ClsID,rclsid));}
     CUnknown *CreateInstance(LPUNKNOWN pUnk, HRESULT *phr)const
     {
     CheckPointer(phr,NULL);
     returnm_lpfnNew(pUnk, phr);
     };
     其中LPFNNewCOMObject和LPFNInitRoutine的宏定义如下：
     typedefCUnknown *(CALLBACK *LPFNNewCOMObject)(LPUNKNOWN pUnkOuter, HRESULT *phr);
     /* A function (can be NULL) which is called from the DLL entrypoint routine for each factory template:
     bLoading - TRUE on DLL load, FALSE on DLL unload
     rclsid - the m_ClsID of the entry*/
     typedefvoid(CALLBACK *LPFNInitRoutine)(BOOL bLoading,constCLSID *rclsid);
     AMOVIESETUP_FILTER的定义稍微复杂一点：
     // Pin上的Media type
     typedefREGPINTYPES
     AMOVIESETUP_MEDIATYPE, * PAMOVIESETUP_MEDIATYPE, * FAR LPAMOVIESETUP_MEDIATYPE;
     typedefREGFILTERPINS
     AMOVIESETUP_PIN, * PAMOVIESETUP_PIN, * FAR LPAMOVIESETUP_PIN;
     // 真正的Filter结构定义
     typedefstruct_AMOVIESETUP_FILTER{
     constCLSID * clsID;
     constWCHAR * strName;
     DWORD dwMerit;
     UINT nPins;
     constAMOVIESETUP_PIN * lpPin;
     } AMOVIESETUP_FILTER, * PAMOVIESETUP_FILTER, * FAR LPAMOVIESETUP_FILTER;
   • 实现Delegation Unknown接口的宏：
     #defineDECLARE_IUNKNOWN
     STDMETHODIMP QueryInterface(REFIID riid, void **ppv) {
     returnGetOwner()->QueryInterface(riid,ppv);
     };
     STDMETHODIMP_(ULONG) AddRef() {
     returnGetOwner()->AddRef();
     };
     STDMETHODIMP_(ULONG) Release() {
     returnGetOwner()->Release();
     };
2. DirectShow Filter实现COM自注册机理[dllsetup.h/dllsetup.cpp/dllentry.cpp]
   • 作为自注册的COM组件，必须支持DllRegisterServer和DllUnregisterServer两个导出函数。而基类的实现中只是简单调用了AMovieDllRegisterServer2函数。
   • AMovieDllRegisterServer2函数的伪代码，其参数Flag控制了Register和Unregister的切换。
     {
     // 获取当前Filter自身的名称，使用了全局变量g_hInit
     // 调用RegisterAllServers(Filter的名称，Flag) 注册所有 OLE servers
     // 通过取得IFilterMapper2或者IFilterMapper接口来调用AMovieSetupRegisterFilter2或者
     //AMovieSetupRegisterFilter完成注册，注意这里使用了全局变量（必须由Filter实现）
     // extern intg_cTemplates;
     // extern CFactoryTemplateg_Templates[];
     其中RegisterAllServers将调用AMovieSetupRegisterServer或者AMovieSetupUnregisterServer。这两个函数负责该Filter 注册为标准的COM组件或者注销，而AMovieSetupRegisterFilter2则把Filter注册在DirectShow的Category下，该Category支持Filter的Enum等操作。
3. DirectShow中常用结构定义[strmif.h]
   • AM_MEDIA_TYPE以及PIN_DIRECTION结构定义
     typedef struct_AMMediaType
     {
     GUID majortype;// 主类型
     GUID subtype;// 子类型
     BOOL bFixedSizeSamples;
     BOOL bTemporalCompression;
     ULONG lSampleSize;
     GUID formattype;
     IUnknown *pUnk;
     ULONG cbFormat;
     /* [size_is] */BYTE *pbFormat;
     } AM_MEDIA_TYPE;
     typedef enum_PinDirection
     { PINDIR_INPUT = 0,
     PINDIR_OUTPUT = PINDI