MSDN学习DirectShow——第四章 使用DirectShow 第一节 用graphedit模拟创建Graph

第四章 使用DirectShow

 (本人英语也不算好，第一次翻译MSDN，希望对初学者有帮助，更快的学习。有不恰当的地方，请多多指出，我会尽早修改。)

4.1 用graphedit模拟创建Graph

（Simulating Graph Building with GraphEdit）

DirectShow提供了一种叫做GraphEdit的调试公共程序，你可以用它来创建和测试filter graphs。

4.1.1  graphedit概述

                   GraphEdit是一个可视化工具，可以创建filter graphs。通过GraphEdit，你可以在写程序代码前实验filter graph。你也可以加载一个你的程序创建的filter graph，来核实你的程序是否创建了正确的Graph。如果你开发一个定制的filter，GraphEdit提供了一种快速的方式测试它：简单的加载一个带有你定制的filter的graph，并且试着运行它。如果你是一个directShow的新手，GraphEdit是一个好的方式，熟悉filter graph和DirectShow架构。

         收下的插图显示了用GraphEdit怎么表示一个简单的filter graph。

 

每一个filter用一个矩形来表示。在filter边缘的小的正方形代表pin。输入pin在filter的左边，输出pin 在右边。箭头代表pin之间的联结。

使用GraphEdit，你可以：

l  你可以使用一个可视的可拖放的界面来创建和修改filter graph。

l  模拟编程调用来创建一个graph，例如IGraphBuilder::RenderFile。

l  运行，暂停，停止 和搜索一个graph。

l  看哪些filter已经在你的电脑上注册了，查看每一个filter的注册信息。

l  观察filter的页面属性。

l  观察pin连接的媒体类型。

4.1.2  使用graphedit

         这一章包含了你可以使用graphedit 工具的做的一些事的简单介绍。要了解关于这些特征更详细的信息，请参照Graphedit程序的帮助文档。

创建一个文件播放graph

Graphedit可以创建一个文件播放 的filter graph。这个特点是与在一个程序中调用IGraphBuilder::RenderFile的方法有同样的作用。在【File】菜单中，点击【Render Media File】。Graphedit显示了Open File对话框。选择一个多媒体文件并点击【Open】。GraphEdit创建了一个filter graph来播放这个你选择的文件。

         你也可以render一个位于url上的媒体文件。从【file】菜单上，点击【Render URL】，Graphedit显示了一个对话框，可以输入URL。

创建一个定制的Filter Graph

         GraphEdit 可以创建一个定制的filter graph，使用您的系统中已经注册的一些fiters。从【Graph】菜单中，点击【Insert Filter】。一个根据filter类型组织的你的系统中的filter的列表的对话框，显示出来。GraphEdit创建了这个列表根据你的注册表信息。下图显示了此对话框。

 

         添加一个filter到graph中，选择filter的名字，并点击【Insert Filters】按钮，或者双击filter的名字。你添加了filter以后，你可以连接两个filter，通过从一个filter的output pin 拖放鼠标到另一个filter的 input pin。如果pin接受了连接，Graphedit画一个箭头来连接他们。

 

运行graph

一旦你已经在graphedit中 创建了一个filter graph，你可以运行这个graph，看到它是否可以像你期望的那样工作。Graph菜单包含了播放，暂停和停止命令的菜单。这些命令分别调用了IMediaControl的Run,Pause，Stop方法。GraphEdit的工具栏有这些命令的按钮如下：

 

注意：GrhphEdit 停止命令（Stop）停止了graph，并且把时间定位为0（假定graph是可定位的）。对于文件回放，这个动作重置了视频窗口到第一帧。然后调用 IMediaControl::Stop。

       如果graph是可定位的，你可以拖动滑动条来定位。拖动滑动条调用了IMediaSeeking::SetPositions方法。

查看属性页

         一些filter支持定制属性页，它提供了设置属性的用户界面。在graphEdit中查看一个filter的属性页，右键点击filter，并在弹出窗口中选择【Properties】。Graphedit显示一个属性页包含此filter定义的属性表。此外，GraphEdit 包含了所有在filter上pin的属性表。Pin属性表被graphedit定义，不是被filter定义。如果pin被连接了，pin的属性表显示连接的媒体类型。另外，它列出了pin的首选媒体类型。

 

4.1.3  从外部过程加载一个graph

Graphedit可以载入一个由外部程序创建的filter graph 。利用这个特点，你可以精确的看到你的程序创建的filter graph，只有少量的额外的代码在你的程序中。

注意：这个特点需要windows 2000，windows XP，或者更新的版本。

注意：从Windows Vista开始，你必须注册proppage.dll才能使这个功能能用。

 

程序必须在运行对象表（Running Object Table（ROT））中注册filter graph实例。ROT是一个全局可查找的表保持运行跟踪。对象在ROT中用别名注册。为了连结graph，GraphEdit查找了ROT中显示名称与特有格式匹配的别名：

!FilterGraph X pid Y

X是十六进制的fiter graph manager的地址， Y是过程ID，也是十六进制的。

当你的程序第一次创建fiter graph，调用下面的函数。

HRESULT AddToRot(IUnknown *pUnkGraph, DWORD *pdwRegister) {     IMoniker * pMoniker = NULL;     IRunningObjectTable *pROT = NULL;       if (FAILED(GetRunningObjectTable(0, &pROT)))     {         return E_FAIL;     }         const size_t STRING_LENGTH = 256;       WCHAR wsz[STRING_LENGTH];     StringCchPrintfW(wsz, STRING_LENGTH, L"FilterGraph %08x pid %08x", (DWORD_PTR)pUnkGraph, GetCurrentProcessId());         HRESULT hr = CreateItemMoniker(L"!", wsz, &pMoniker);     if (SUCCEEDED(hr))     {         hr = pROT->Register(ROTFLAGS_REGISTRATIONKEEPSALIVE, pUnkGraph,             pMoniker, pdwRegister);         pMoniker->Release();     }     pROT->Release();         return hr; }

这个函数创建了一个别名和一个新的ROT入门。第一个参数是一个指向filter graph的指针。第二参数接收一个识别新ROT入口的值。在程序释放filter graph前，调用以下的函数移除ROT入口。pdwRegister 这个参数是AddToRot函数返回的标识。

void RemoveFromRot(DWORD pdwRegister) {     IRunningObjectTable *pROT;     if (SUCCEEDED(GetRunningObjectTable(0, &pROT))) {         pROT->Revoke(pdwRegister);         pROT->Release();     } }

 

以下的代码示例显示了怎么调用这些函数。在这个例子中，添加和删除ROT入口的代码是有条件编译的，因此只包含了调试版。

IGraphBuilder *pGraph; DWORD dwRegister;     // Create the filter graph manager. CoCreateInstance(CLSID_FilterGraph, NULL, CLSCTX_INPROC_SERVER,                         IID_IGraphBuilder, (void **)&pGraph); #ifdef _DEBUG hr = AddToRot(pGraph, &dwRegister); #endif   // Rest of the application (not shown).   #ifdef _DEBUG RemoveFromRot(dwRegister); #endif pGraph->Release();

在GraphEdit中查看filter graph，同时运行你的程序和graphedit。在GraphEdit【File】菜单中，点击【Connect to Remote Graph…】。在【Connect To Graph】对话框中，选择你程序的PID并点击【OK】。GraphEdit加载filter graph并显示。不要用其他的GraphEdit功能在这个graph中，可能会引用 不可预料的结果。例如，不要添加和删除filter，或者停止和开始graph。在退出程序前关闭graphEdit。

注意：你的程序可能引起中断当它存在时。你可以忽略它们。

下图显示了【Connect To Graph】对话框。

 

GraphEdit加载一个graph,它在目标程序的环境中执行。因此，GraphEdit限制因为它在等待一个线程。例如，这在调试你的代码时可能发生。

这个功能应该只用在调试版的程序中，不是发布版中，因为它可能使别程序查看或者控制filter graph。

 

从命令行连接到一个远程graph

GraphEdit支持命令行选项，加载一个远程Graph自动启动。语法是：

GraphEdt -a moniker

其中的moniker是一个用AddToRot函数先前创建和描述的。

 

4.1.4  保存一个filter graph到graphedit文件中

下面的代码例子显示了怎么保存一个filter graph 成.grf文件。这可能对你调试你的程序有用。

HRESULT SaveGraphFile(IGraphBuilder *pGraph, WCHAR *wszPath) {     const WCHAR wszStreamName[] = L"ActiveMovieGraph";     HRESULT hr;         IStorage *pStorage = NULL;     hr = StgCreateDocfile(         wszPath,         STGM_CREATE | STGM_TRANSACTED | STGM_READWRITE | STGM_SHARE_EXCLUSIVE,         0, &pStorage);     if(FAILED(hr))     {         return hr;     }       IStream *pStream;     hr = pStorage->CreateStream(         wszStreamName,         STGM_WRITE | STGM_CREATE | STGM_SHARE_EXCLUSIVE,         0, 0, &pStream);     if (FAILED(hr))     {         pStorage->Release();            return hr;     }       IPersistStream *pPersist = NULL;     pGraph->QueryInterface(IID_IPersistStream, (void**)&pPersist);     hr = pPersist->Save(pStream, TRUE);     pStream->Release();     pPersist->Release();     if (SUCCEEDED(hr))     {         hr = pStorage->Commit(STGC_DEFAULT);     }     pStorage->Release();     return hr; }

例如，下面的代码创建了一个回放的graph和保存它成MyGraph.grf。

void __cdecl main(void) {     HRESULT hr;     IGraphBuilder *pGraph;     CoInitialize(NULL);         // Create the Filter Graph Manager and render a file.     CoCreateInstance(CLSID_FilterGraph, NULL, CLSCTX_INPROC_SERVER,         IID_IGraphBuilder, reinterpret_cast<void**>(&pGraph));     hr = pGraph->RenderFile(L"C:\\Video.avi", NULL);       if (SUCCEEDED(hr))     {         hr = SaveGraphFile(pGraph, L"C:\\MyGraph.grf");     }         pGraph->Release();     CoUninitialize(); }

关于StgCreateDocfile函数的更多信息，请查看SDK文档。

 

4.1.5  加载一个可编程graphedit文件

（Loading a GraphEdit File Programmatically ）

程序可以使用IPersistStream接口来加载一个grf文件，使用如下 的代码：

HRESULT LoadGraphFile(IGraphBuilder *pGraph, const WCHAR* wszName) {     IStorage *pStorage = 0;     if (S_OK != StgIsStorageFile(wszName))     {         return E_FAIL;     }     HRESULT hr = StgOpenStorage(wszName, 0,         STGM_TRANSACTED | STGM_READ | STGM_SHARE_DENY_WRITE,         0, 0, &pStorage);     if (FAILED(hr))     {         return hr;     }     IPersistStream *pPersistStream = 0;     hr = pGraph->QueryInterface(IID_IPersistStream,              reinterpret_cast<void**>(&pPersistStream));     if (SUCCEEDED(hr))     {         IStream *pStream = 0;         hr = pStorage->OpenStream(L"ActiveMovieGraph", 0,             STGM_READ | STGM_SHARE_EXCLUSIVE, 0, &pStream);         if(SUCCEEDED(hr))         {             hr = pPersistStream->Load(pStream);             pStream->Release();         }         pPersistStream->Release();     }     pStorage->Release();     return hr; }

注意： 在先前代码的IPersistStream::Load 函数能返回一个DirectShow错误或者成功的代码。想查看一系列返回值，去看Error 和 Success codes。

GraphEdit文件仅被用作调试和调试。我们不打算用它来终端用户程序。

更多StgIsStorageFile和StgOpenStorage函数的信息，请参照SDK文档。