如何播放文件
[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
本文旨在介绍 DirectShow 编程的风格。 它提供一个简单的控制台应用程序，用于播放音频或视频文件。 该程序只有几行长，但它演示了 DirectShow 编程的一些强大功能。
如 DirectShow 应用程序编程简介 一文所述，DirectShow 应用程序始终执行相同的基本步骤：
- 创建 Filter Graph 管理器的实例。
- 使用 Filter Graph 管理器生成筛选图。
- 运行图形，使数据在筛选器中移动。
若要编译和链接本主题中的代码，请包含头文件 Dshow.h 和指向静态库文件 strmiids.lib 的链接。 有关详细信息，请参阅 生成 DirectShow 应用程序。
首先调用 CoInitialize 或 CoInitializeEx 来初始化 COM 库：
HRESULT hr = CoInitialize(NULL);
if (FAILED(hr))
{
// Add error-handling code here. (Omitted for clarity.)
}
为了简单起见，此示例忽略返回值，但应始终从任何方法调用检查 HRESULT 值。
接下来，调用 CoCreateInstance 以创建 Filter Graph 管理器：
IGraphBuilder *pGraph;
HRESULT hr = CoCreateInstance(CLSID_FilterGraph, NULL,
CLSCTX_INPROC_SERVER, IID_IGraphBuilder, (void **)&pGraph);
如图所示，CLSID_FilterGraph CLSID) (类标识符。 Filter Graph 管理器由进程内 DLL 提供，因此执行上下文 CLSCTX_INPROC_SERVER。 DirectShow 支持自由线程模型，因此还可以使用 COINIT_MULTITHREADED 标志调用 CoInitializeEx。
调用 CoCreateInstance 将返回 IGraphBuilder 接口，该接口主要包含用于生成筛选器图的方法。 此示例需要另外两个接口：
- IMediaControl 控件流式处理。 它包含用于停止和启动图形的方法。
- IMediaEvent 具有从 Filter Graph 管理器获取事件的方法。 在此示例中， 接口用于等待播放完成。
这两个接口都由 Filter Graph 管理器公开。 使用返回的 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);
此方法将阻止，直到文件播放完成，或直到指定的超时间隔结束。 值 INFINITE 表示应用程序无限期地阻止，直到文件播放完毕。 有关事件处理更真实的示例，请参阅 响应事件。
应用程序完成后，释放接口指针并关闭 COM 库：
pControl->Release();
pEvent->Release();
pGraph->Release();
CoUninitialize();
示例代码
下面是本文中所述的示例的完整代码：
#include <dshow.h>
void main(void)
{
IGraphBuilder *pGraph = NULL;
IMediaControl *pControl = NULL;
IMediaEvent *pEvent = NULL;
// Initialize the COM library.
HRESULT hr = CoInitialize(NULL);
if (FAILED(hr))
{
printf("ERROR - Could not initialize COM library");
return;
}
// Create the filter graph manager and query for interfaces.
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);
// Build the graph. IMPORTANT: Change this string to a file on your system.
hr = pGraph->RenderFile(L"C:\\Example.avi", NULL);
if (SUCCEEDED(hr))
{
// Run the graph.
hr = pControl->Run();
if (SUCCEEDED(hr))
{
// Wait for completion.
long evCode;
pEvent->WaitForCompletion(INFINITE, &evCode);
// Note: Do not use INFINITE in a real application, because it
// can block indefinitely.
}
}
pControl->Release();
pEvent->Release();
pGraph->Release();
CoUninitialize();
}
相关主题