如何播放文件

  • 项目

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

本文旨在介绍 DirectShow 编程的风格。 它提供一个简单的控制台应用程序，用于播放音频或视频文件。 该程序只有几行长，但它演示了 DirectShow 编程的一些强大功能。

如 DirectShow 应用程序编程简介 一文所述，DirectShow 应用程序始终执行相同的基本步骤：

  1. 创建 Filter Graph 管理器的实例。
  2. 使用 Filter Graph 管理器生成筛选图。
  3. 运行图形，使数据在筛选器中移动。

若要编译和链接本主题中的代码，请包含头文件 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();
}

基本 DirectShow 任务