如何使用DirectShow播放一个文件

本文的目的是给出DirectShow编程的样式。这是一个简单的控制台应用程序，用来播放一个音频或视频文件。程序只有几行，但是它示范了DirectShow编程的某些能力。
　　如＜DirectShow应用程序编程介绍＞所写，一个DirectShow应用程序运行的基本步骤为：
1、创建一个筛选器表管理器的实例

2、使用筛选器表管理器生成一个筛选器表

3、运行表，使数据在筛选器中流动。

　　调用CoIntitialize来初始化COM库

HRESULT hr = CoInitialize(NULL);

if (FAILED(hr))

{

// 在这里添加错误处理代码(Omitted for clarity.)

}

　　为了简单化，此例子忽略了返回值，但是您最好在方法调用中检查HRESULT的值。

　　下面，调用CoCreateInstance来创建筛选器表管理器：

IGraphBuilder *pGraph;

HRESULT hr = CoCreateInstance(CLSID_FilterGraph, NULL,

CLSCTX_INPROC_SERVER, IID_IGraphBuilder, (void **)&pGraph);

　 　如上所示，类标识（CLSID）为CLSID_FilterGraph。筛选器表管理器由一个进程内的DLL提供，所以执行上下文是 CLSCTX_INPROC_SERVER。DirectShow支持自由自由线程处理模式，因此您也可以使用COINIT_MULTITHREADED 标志调用CoInitializeEx。
　　对CoCreateInstance的调用返回IGraphBuilder接口，它主要包含了生成筛选器表的方法。此例中用到的另两个接口为：

IMediaControl，作用是控制流。它包含了停止和启动表的方法
IMediaEvent，它包含的方法是从筛选器表管理器中得到事件。在此例中，此接口用来等待播放的结束。

　　这两个接口都是出现在筛选器表管理器中。可以使用返回的IGraphBuilder指针来查询。

IMediaControl *pControl;

IMediaEvent *pEvent;

hr = pGraph->QueryInterface(IID_IMediaControl, (void **)&pControl);

hr = pGraph->QueryInterface(IID_IMediaEvent, (void **)&pEvent);

　　现在您可以生成筛选器表了。要播放文件，可以调用下列方法：

hr = pGraph->RenderFile(L"C://Example.avi", NULL);

　　IGraphBuilder::RenderFile方法生成一个筛选器表，用以播放指定的文件。第一个参数是文件名称，用一个宽字符（2字节）字符串表示。第二个参数是保留参数，必须为NULL。

　　如果指定的文件不存在，或文件格式无法，此方法将失败。如果方法调用成功，筛选器还原器就做好播放的准备了。要运行表，调用IMediaControl::Run方法。

hr = pControl->Run();

　　当筛选器运行时，数据从筛选器中移出，并以视频和音频的方式还原出来。播放会启动另一个线程。您可以调用IMediaEvent::WaitForCompletion方法。

long evCode = 0;

pEvent->WaitForCompletion(INFINITE, &evCode);

　　当应用程序结束时，将释放接口指针并关闭COM库。

pControl->Release();

pEvent->Release();

pGraph->Release();

CoUninitialize();

代码范例

　　这里列出了本文介绍的例子的完整代码：

#include <dshow.h>

void main(void)

{

IGraphBuilder *pGraph = NULL;

IMediaControl *pControl = NULL;

IMediaEvent *pEvent = NULL;
// 初始化COM库

HRESULT hr = CoInitialize(NULL);

if (FAILED(hr))

{

printf("ERROR - Could not initialize COM library");

return;

}
// 创建筛选器表管理器，并查询接口

hr = CoCreateInstance(CLSID_FilterGraph, NULL, CLSCTX_INPROC_SERVER,

IID_IGraphBuilder, (void **)&pGraph);

if (FAILED(hr))

{

printf("ERROR - Could not create the Filter Graph Manager.");

return;

}
hr = pGraph->QueryInterface(IID_IMediaControl, (void **)&pControl);

hr = pGraph->QueryInterface(IID_IMediaEvent, (void **)&pEvent);
// 创建表。重点：将字符串改为您系统上的文件名称

hr = pGraph->RenderFile(L"C://Example.avi", NULL);

if (SUCCEEDED(hr))

{

// 运行表

hr = pControl->Run();

if (SUCCEEDED(hr))

{

//　等待结束

long evCode;

pEvent->WaitForCompletion(INFINITE, &evCode);
// 注意：在实际应用程序中不要使用INFINITE

// 因为它对应用程序的阻塞很不确定

}

}

pControl->Release();

pEvent->Release();

pGraph->Release();

CoUninitialize();

}
　　此方法将阻塞，直到文件播放完毕，或超出了指定的时间。INFINITE值是指应用程序将阻塞到文件播放完。