filter开发1

学习directshow已经有几天了，下面将自己的学习心得写下来，希望对其他的人有帮助。 Filter实质是个COM组件，所以学习开发Filter之前你应该对com的知识有点了解。Com组件的实质是一个实现了纯虚指针接口的C++对象。 关于com的东西，这里不多讲。 一、给vc配置DirectShow的开发环境 　　无论开发Filter还是开发Dshow的应用程序都要配置一下开发环境的，其实就是包含一下dshow用到的头文件和动态库。 选择Tools菜单下面的Options。在弹出的Option对话框配置如下： 图1 添加头文件 选择动态库文件添加到工程中 图2 添加动态库 二、创建工程以及Filter的入口函数 创建工程：　　 一般情况下，创建Filter使用一个普通的Win32 DLL项目。而且，一般Filter项目不使用MFC。这时，应用程序通过CoCreateInstance函数Filter实例； Filter与应用程序在二进制级别的协作。另外一种方法，也可以在MFC的应用程序项目中创建Filter。在vc里新建一个工程，选择win32动态库，如下图 图3 图4 　　 这样生成了一个简单的DLL，只有一个Dllmain入口函数。 下面我要给这个filter添加入口函数了。 Filter是个基于DLL的com组件，所以一般的Filter都要实现下面几个入口函数： DllMain DllGetClassObject DllCanUnloadNow DllRegisterServer DllUnregisterServer 首先定义导出函数：　　要导出这些函数有两种方法，一是在定义函数时使用导出关键字_declspec(dllexport)，另外一种方法是在创建DLL文件时使用模块定义文件.Def。 使用导出函数关键字_declspec(dllexport)创建MyDll.dll就是在 .h文件中定义定义函数如下： extern "C" _declspec(dllexport)BOOL DllRegisterServer; 等等 　　 为了用.def文件创建DLL，往该工程中加入一个文本文件，命名为MyDll.def，再在该文件中加入如下代码： LIBRARY MyFilter.ax EXPORTS DllMain PRIVATE DllGetClassObject PRIVATE DllCanUnloadNow PRIVATE DllRegisterServer PRIVATE DllUnregisterServer PRIVATE 　　 其中LIBRARY语句说明该def文件是属于相应DLL的，EXPORTS语句下列出要导出的函数名称。我们可以在.def文件中的导出函数后加@n，如Max@1，Min@2， 表示要导出的函数顺序号，在进行显式连时可以用到它。该DLL编译成功后，打开工程中的Debug目录，同样也会看到MyDll.dll和MyDll.lib文件。　　 然后要定义这些函数的实现了，其实这些工作dshow的基类里都已经替我们做好了，我们所要做的就拿来用就是了，最重要的三个函数的实现一般如下 　 STDAPI DllRegisterServer() { return AMovieDllRegisterServer2(TRUE); } STDAPI DllUnregisterServer() { return AMovieDllRegisterServer2(FALSE); } extern "C" BOOL WINAPI DllEntryPoint(HINSTANCE, ULONG, LPVOID); BOOL APIENTRY DllMain(HANDLE hModule, DWORD dwReason, LPVOID lpReserved) { return DllEntryPoint((HINSTANCE)(hModule), dwReason, lpReserved); } 　　 其中DllEntryPoint 是在C:/DX90SDK/Samples/C++/DirectShow/BaseClasses/dllentry.cpp定义的，如果感兴趣我们可以去看看它的定义。 AMovieDllRegisterServer2函数是在下面 C:/DX90SDK/Samples/C++/DirectShow/BaseClasses/dllsetup.cpp这个文件定义的，具体实现可以自己看看。　　 到了这里你恐怕要做点工作，还是要设置一下你的项目环境，否则恐怕你编译是通不过的，因为你用到了基类的一些东西，所以你要将你的dshow基类的定义和库文件包含进来。 首先包含： #include Streams.h 其次在Project –Setting菜单下配置自己的Filter输出的名字和连接的lib文件 图5 其中library modules里的包含的动态库如下 c:/DX90SDK/Samples/C++/DirectShow/BaseClasses/debug/strmbasd.lib msvcrtd.lib quartz.lib vfw32.lib winmm.lib kernel32.lib advapi32.lib version.lib largeint.lib user32.lib gdi32.lib comctl32.lib ole32.lib olepro32.lib oleaut32.lib uuid.lib 　　 此时你编译一下，好像还是通不过，它提示有一个全局的用于实现COM接口的变量没有定义，不着急，下面我们就开始实现Filter的com接口。 三、如何实现Filter 的类厂对象 　　 我们知道一个Filter是一个com组件，所以它com特性的实现其实在其基类中实现的，比如IUnknown接口，我们直接从基类派生出我们的Filter后，它就支持com接口了，它就是一个com组件了。　　所有的com组件为了实现二进制的封装，所以连创建的接口都封装了，因此每个com对象都有个类对象（也叫类厂对象，本身也是com对象，用来创建com组件）来创建com组件。下面温习一下com组件的创建过程，其中涉及到几个函数：　 当客户端要创建一个com组件时，它通过底层的COM API函数 CoGetClassObject（）使用SCM的服务，这个函数请SCM把一个指针绑定到客户端请求的com组件的类对象上， 其实在CoGetClassObject（）里它装载了该DLL的库，通过该dll的导出函数DllGetClassObject（）；DllGetClassObject根据客户端提供的com组件CLASSID，返回该com组件类对象的指针。下面com组件的创建和SCM无关了。 客户端利用组件的类对象（类厂对象）的IClassFactory::CreateInstance方法创建com组件。 Filter在这里使用了一个类厂模板类来当作Filter的类厂对象。下面看看类厂在DShow是怎么工作的。 　 　　 类厂对象也是一个com组件。本来DllGetClassObject是应该由我们自己完成一个函数，在directshow基类里已经完成了，我们不用管它了。它的功能就是来寻找这个DLL中的类厂对象，看是否有符合客户端请求的类厂对象。　　DLL里声明了一个全局的类厂模板数组，当DllGetClassObject请求类厂对象的时候，它就搜索这个数组，看是否有和CLSID匹配的类厂对象。当它找到一个匹配的CLSID，它就创建一个类厂对象，然后讲类厂指针返回给CoGetClassObject， 然后客户端可以根据返回去的类厂指针，调用 IClassFactory::CreateInstance方法创建组件，类厂就根据数组里定义的方法创建com组件。 factory template包含下列变量： const WCHAR * m_Name; // Name const CLSID * m_ClsID; // CLSID LPFNNewCOMObject m_lpfnNew; // Function to create an instance of the component LPFNInitRoutine m_lpfnInit; // Initialization function (optional) const AMOVIESETUP_FILTER * m_pAMovieSetup_Filter; // Set-up information (for filters) 其中的两个函数指针m_lpfnNew and m_lpfnInit使用下面的定义