如何播放文件

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

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

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

若要编译并链接本主题中的代码,请包含头文件 Dshow.h,并链接到静态库文件 strmiids.lib。 有关详细信息,请参阅生成DirectShow应用程序

通过调用 CoInitializeCoInitializeEx 初始化 COM 库来"开始"菜单:

HRESULT hr = CoInitialize(NULL);
if (FAILED(hr))
{
    // Add error-handling code here. (Omitted for clarity.)
}

为简单起见,此示例忽略返回值,但应始终检查任何方法调用中的 HRESULT 值。

接下来,调用 CoCreateInstance 创建筛选器Graph管理器:

IGraphBuilder *pGraph;
HRESULT hr = CoCreateInstance(CLSID_FilterGraph, NULL, 
    CLSCTX_INPROC_SERVER, IID_IGraphBuilder, (void **)&pGraph);

如图所示,CLSID) (类标识符CLSID_FilterGraph。 筛选器Graph管理器由进程内 DLL 提供,因此执行上下文CLSCTX_INPROC_SERVER。 DirectShow支持自由线程模型,因此还可以使用 COINIT_MULTITHREADED 标志调用 CoInitializeEx

CoCreateInstance 的调用返回 IGraphBuilder 接口,该接口主要包含用于生成筛选器图的方法。 此示例需要另外两个接口:

  • IMediaControl 控件流式处理。 它包含用于停止和启动图形的方法。
  • IMediaEvent 具有从筛选器Graph管理器获取事件的方法。 在此示例中,接口用于等待播放完成。

这两个接口由筛选器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);

此方法会阻止文件播放,或直到指定的超时间隔用完为止。 VALUE 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任务