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文档。
posted on 2012-05-17 09:47 cv_ml_张欣男 阅读(3009) 评论(0) 编辑 收藏 举报