《DirectShow开发指南》学习笔记

Filter原理

Filter概述

Filter是DirectShow中最近本的概念。DirectShow使用Filter Graph来管理Filter（管理者叫做Filter Graph Manager）。Filter Graph是Filter的“容器”，而Filter是Filter Graph中的最小功能模块。

Filter一般由一个或多个Pin组成，Filter之间通过Pin相互连接，构成一条顺序的链路。Filter根据实现功能的不同大致可分为3类：Source Filters、Transform Filters和Rendering Filters。另一种使用的判别方法是根据Filter包含的输入Pin或者输出Pin的数量来判断：仅含有输出Pin，没有输入Pin的Filter为Source Filter；既有输入Pin又有输出Pin的Filter为Transform Filter；仅有输入Pin，没有输出Pin的Filter为Rendering Filter。

Filter是一种COM组件。为了实现在Filter Graph中的统一操作，每个Filter上都至少实现了IBaseFilter接口。实现Filter的文件一般是一个DLL，扩展名可以使.dll，但更多是.ax。跟普通的COM组件一样，Filter的创建是通过API函数CoCreateInstance来完成的，代码如下：

STDAPI CoCreateInstance(
    REFCLSID rclsid, //class identifier (CLSID) of the object
    LPUNKNOWN pUnkOuter, //Pointer to controlling IUnknown
    DWORD dwClsContext, //Context for running executable code
    REFIID riid, //Reference to the identifier of the interface
    LPVOID * ppv //the interface pointer requested in riid
);

其中，参数rclsid指定要创建的Filter的CLSID；因为绝大多数情况下创建的Filter不是被“聚合”（Aggregation）的，所以pUnkOuter指定为NULL；dwClsContext可以指定为CLSCTX_INPROC_SERVER，以创建进程内组件对象；riid在创建Filter成功后获得的接口的ID，一般为IID_IBaseFilter，也可以是其他特殊的接口；ppv用于获得接口对象的指针。

Filter必须加入到Filter Graph且接入到工作链路中才能发挥作用。如果想绕过Filter Graph而直接使用Filter实现的模块功能，微软公司提供了另一种解决方案，就是将Filter功能移植成DirectX媒体对象（DMO）。

Filter的注册

既然Filter是一种COM组件，使用前就必须先注册。Filter的注册程序为regsvr32.exe（唯一操作系统目录的system32子目录下）。假设现在有一个Filter文件，它的完整路径为C:\DSFilter\myFilter.ax，那么注册这个Filter的方法为：在命令行状态下，执行regsvr32 C:\DSFilter\myFilter.ax。随后会弹出一个对话框，告诉Filter注册是否成功。

注销Filter也是使用regsvr32.exe程序，方法为加命令行参数/u，即执行regsvr32 /u C:\DSFilter\myFilter.ax。另外一个命令行参数“/s”可以禁止执行regsvr32.exe后弹出提示对话框。

问：给出一个Filter的CLSID，如何判断这个Filter是否已经注册？

答：最简单的办法就是使用CoCreateInstance函数创建这个Filter，然后根据函数的返回值去判断。代码如下：