如何播放文件

项目
05/11/2022

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

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

创建筛选器Graph管理器的实例。
使用筛选器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 创建筛选器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任务

如何播放文件

此页面有帮助吗?

示例代码

相关主题