转帖:如何注册Filter

转载 2012年03月21日 16:23:54

参考文章:

http://apps.hi.baidu.com/share/detail/16291532

 

AX文件的一个对外接口DllRegisterServer,由外部调用,比如注册AX的时候:regsvr32 xxx.ax

       通常情况下,我们的filter可能注册在”Direct Show”目录下,那么直接调用
       // Creates registry entries for the DLL
STDAPIDllRegisterServer()
{
return AMovieDllRegisterServer2(TRUE);
}

AMovieDllRegisterServer2在DX的帮助文档内的说明如下:
The AMovieDllRegisterServer2 函数为g_Templates 数组中的每个组件创建注册入口. 然而这个函数有一些限制,

首先,它给每个filter分配“DirectShow Filters”分类(CLSID_LegacyAmFilterCategory), 但是不是每个filter都属于这个分类. 比如Capture filters and compression filters,有他们自己的分类.

第二,如果你的fitler支持一个硬件设备,你可能需要去注册两个增加AMovieDLLRegisterServer2 没有处理的信息pieces,: the medium and the pin category. A medium defines a method of communication in a hardware device, such as a bus. The pin category defines the function of a pin. For information on mediums, see KSPIN_MEDIUM in the Microsoft Windows Driver Development Kit (DDK). For a list of pin categories, see Pin Property Set.
      
如果我们的引擎需要注册到DirectShow之外的目录,又该如何做?
 // 注册Filter到Video Compressor
REGFILTER2 rf2FilterReg =
{
    1,                                    // Version 1 (no pin mediums or pin category).
    MERIT_NORMAL,       // Merit.
    1,                                   // Number of pins.
    &sudPins                    // Pointer to pin information.
};

//为DLL创建注册入口
STDAPI DllRegisterServer(void)
{
    HRESULT hr = E_FAIL;
    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_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
注销DirectShow内的引擎
// Removes registry entries for the DLL
STDAPI DllUnregisterServer()
{
return AMovieDllRegisterServer2(FALSE);
}

       注销指定目录下的引擎
       // 注销Video Compressor下的引擎
       // Removes registry entries for the DLL
STDAPI DllUnregisterServer()
{
    HRESULT hr = E_FAIL;
    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;
}

给Filter起个名字
// Pin的type分为Major Type 和 Subtype
// 比如,Major Type = Video, Subtype = MPEG-2
const AMOVIESETUP_MEDIATYPE sudPinTypes =
{
&MEDIATYPE_NULL,            // Major type
&MEDIASUBTYPE_NULL           // Subtype
};

const AMOVIESETUP_PIN psudPins[] =
{
       // 定义Input Pin的信息
{
L"Input",                 // String pin name
FALSE,             // Is it rendered
FALSE,             // Is it an output
FALSE,             // Allowed none
FALSE,             // Allowed many
&CLSID_NULL,        // Connects to filter
0           // Connects to pin
1,                  // Number of types
&sudPinTypes
},     // The pin details
{
L"Output",          // String pin name
FALSE,              // Is it rendered
TRUE,               // Is it an output
FALSE,              // Allowed none
FALSE,              // Allowed many
&CLSID_NULL,        // Connects to filter
0,          // Connects to pin
1,                  // Number of types
&sudPinTypes        // The pin details
       }
};

// Declare filter information
const AMOVIESETUP_FILTER sudFilter =
{
&CLSID_MPKiller,       // Filter CLSID
L"HQ MP Killer",        // Filter name
0x8800000,                    // Its merit
2,                      // Number of pins
psudPins                      // Pin details
};

// declare a global array of CFactoryTemplate class instances, named g_Templates. Each
// CFactoryTemplate class contains registry information for one filter. Several filters can
// reside in a single DLL; simply include additional CFactoryTemplate entries. You can
// also declare other COM objects, such as property pages
// 在同一个DLL或者AX内,可以有多个引擎,比如系统目录下的quartz.dll。
// 所以,如果有多个引擎,相应的数组的大小就是引擎的个数。
CFactoryTemplateg_Templates[] =
{
{
L"HQ MP Killer",
&CLSID_MPKiller,
CImplement::CreateInstance,
NULL,
&sudFilter
}
};

int g_cTemplates = sizeof(g_Templates) / sizeof(g_Templates[0]);       // 有几个引擎

允许Filter应用
// CreateInstance 是CFactory的一个接口,在Filter内部实现它
CUnknown* WINAPI CImplement::CreateInstance(    LPUNKNOWN pUnk,
                                                                                    HRESULT *pHr)
{
    CImplement *pFilter = new CImplement ();
    if (!pFilter)
    {
        *pHr = E_OUTOFMEMORY;
    }
    return pFilter;
}

Filter的Merit
Graph 会使用“傻子”机制联接不同的filter,这就要通过filter的merit值的高低进行“傻子”联接。

该联接要使用IFilterMapper2::EnumMatchingFilters方法。
Merit:
enum
{
    MERIT_PREFERRED     = 0x800000,
    MERIT_NORMAL        = 0x600000,
    MERIT_UNLIKELY      = 0x400000,
    MERIT_DO_NOT_USE    = 0x200000,
    MERIT_SW_COMPRESSOR = 0x100000,
    MERIT_HW_COMPRESSOR = 0x100050
};
<= MERIT_DO_NOT_USE的Merit的Filter,系统是不会去“傻子”联接的。当然Merit值可以是任意值,而不一定是枚举出来的。

确定Filter的用途
不同的Filter有不同的用途,可以选择不同的基类,实现不同的方法。详见DirectX 文档。Filter的种类,在内进行了详细的描述root\DirectShow\DirectShow Reference\Constants and GUIDs\Filter Categories。

添加属性页
CFactoryTemplateg_Templates[2] =
{
    {
              g_wszArcIPCam,                       // Name
              &CLSID_ArcIPCam,                  // CLSID
              CArcIPCam::CreateInstance, // Method to create an instance of MyComponent
              NULL,                                     // Initialization function
              &sudArcIPCamSourceFilter      // Set-up information (for filters)
    },

       {
                     // 这些数据,为属性页准备
              g_wszArcIPCamProperty,
              &CLSID_ArcIPCamProperty,
              CArcIPCamProperty::CreateInstance
       }
};
     
class CArcIPCam : public xxx, public IArcIPCam, public ISpecifyPropertyPages
{
private:
    // Constructor is private because you have to use CreateInstance
    CArcIPCam(IUnknown *pUnk, HRESULT *phr);
    ~CArcIPCam();

    CArcIPCamPin *m_pPin;

public:
    static CUnknown * WINAPI CreateInstance(IUnknown *pUnk, HRESULT *phr);
    DECLARE_IUNKNOWN;

           // Property Page---
           STDMETHODIMP GetClassID(CLSID *pClsid);
    // Basic COM - used here to reveal our property interface.
    STDMETHODIMP NonDelegatingQueryInterface(REFIID riid, void ** ppv);
    // return our property pages
    STDMETHODIMP GetPages(CAUUID * pPages);
}
       这三个函数必须实现。

注册DirectShow Filter信息 转帖

注册DirectShow Filter信息 收藏 编写自己的DirectShow Filt...
  • rzjkl1980
  • rzjkl1980
  • 2010年05月24日 11:24
  • 2236

discuz X2转帖工具、采集工具 使用介绍(原创)

由于是winform程序,请先保证你的电脑已经安装.netframework2.0以上版本。   介绍下界面上文本框按钮的作用,以下以厦门艺术网为例:   文章来源:http://www.xmys...
  • liaobc
  • liaobc
  • 2012年05月17日 21:59
  • 1586

如何注册Filter

AX文件的一个对外接口DllRegisterServer,由外部调用,比如注册AX的时候:regsvr32 xxx.ax       通常情况下,我们的filter可能注册在”Direct Show”...
  • mao0514
  • mao0514
  • 2014年09月22日 17:31
  • 1536

18.玩转Spring Boot 注册Servlet、Filter、Listener

玩转Spring Boot 注册Servlet、Filter、Listener 在Servlet 3.0之前我们都是使用web.xml进行配置,需要增加Servlet、Filter或者Listene...
  • cl_andywin
  • cl_andywin
  • 2017年02月01日 21:36
  • 2369

DirectShow 注册 filter

用如下的命令注册:regsvr32  wavdest.ax 附:注册与反注册ActiveX控件 regsvr32.exe使用详解:   regsvr3...
  • luckyboy101
  • luckyboy101
  • 2012年07月31日 13:52
  • 1417

实现一般Dz论坛的刷帖功能

本文用于记录一个简单的自动论坛回帖功能,只能用于一般DZ论坛,在河畔上做过测试,功能比较简单,基于HTTP1.0 而且是绑定了我自己的账号与电脑。后续可以试着实现其他功能。 直接上代码吧!pa...
  • weiguang111
  • weiguang111
  • 2016年01月05日 16:46
  • 909

Filter的注册2

既然Filter是一种COM组件,使用前就必须先注册。Filter的注册程序为regsvr32.exe (位于操作系统目录的system32子目录下)。假设现在有一个Filter文件,它的完整路径为C...
  • mao0514
  • mao0514
  • 2014年09月22日 17:41
  • 1385

[转帖]卡尔曼滤波器通俗解释 – Kalman Filter

很精妙的一篇关于卡尔曼滤波的文章。我无法找到原始出处,如果你知道就q我知吧。 我看到的链接多半是源自cdsn,而csdn的引用者又把来源指向了。 可惜我打不开vchelp算法论坛的网站。 接下来转贴过...
  • b5w2p0
  • b5w2p0
  • 2014年01月20日 10:58
  • 1630

洪水帖

看了楼主的帖子,不由得精神为之一振,自觉七经八脉为之一畅,七窍倒也开了六巧半,自古英雄出少年,楼主年纪轻轻,就有经天纬地之才,定国安邦之智,古人云,卧龙凤雏得一而安天下,而今,天佑我大中华,沧海桑田5...
  • tom0421
  • tom0421
  • 2006年10月17日 14:36
  • 803

[转贴] 感人的邻居夫妻

(一)    从搬进这家民房的第一天,我就开始怀疑我隔壁的那个储藏室根本没住人。一天到晚黑黢黢的,没半点声响。    我终于还是忍受不了房间里那个破沙发了,便又一次跟房东要求,能不能让我把一些杂物放进...
  • net2005xd
  • net2005xd
  • 2007年03月21日 14:30
  • 902
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:转帖:如何注册Filter
举报原因:
原因补充:

(最多只允许输入30个字)