DirectShow多媒体解码和回放

DirectShow建立在COM组件技术基础上，所以开发DirectShow程序必须要掌握COM组件技术。DirectShow与COM紧密相连，它所有的部件和功能都由COM接口来构造和实现，其开发方式相当灵活，没有固定的模式，通常随不同的需要使用不同的COM接口。但是其中几个重要的接口确实经常需要用到的：IGraphBuilder接口，这是最为重用的COM接口，用来创建Filter Graph Manager；IMediaControl接口，用来控制流媒体在滤波器图表（Filter Graph）中的流动，例如流媒体的启动和停止；IMediaEvent接口，该接口在Filter Graph发生一些事件时用来创建事件的标志信息并传送给应用程序。

　　一个典型的DirectShow应用程序的开发通常遵循的步骤为：

　　1）通过API函数CoCreateInstance（）创建一个Filter Graph Manager 实例；

　　2）通过调用QueryInterface ( )函数来获取Filter Graph 和IMediaEvent组件的指针；

　　3）对Filter Graph进行控制和对事件作出响应。

　　下面举一个简单的例子来说明如何利用DirectShow技术对多媒体流进行解码回放的。首先生成一个名为MediaPlay的单文档应用程序，定义一个名字为MediaPlay的函数，该函数的具体实现代码为：

 

void PlayMovie(LPTSTR lpszMovie) {  　IMediaControl *pMC = NULL;  　IGraphBuilder *pGB = NULL; 　IMediaEventEx *pME = NULL; 　long evCode; // something to hold a returned event code 　hr = CoCreateInstance(CLSID_FilterGraph, NULL, CLSCTX_INPROC, 　IID_IMediaControl, (void **)&pMC); 　hr = pMC->QueryInterface(IID_IGraphBuilder, (void **)&pGB); 　hr = pMC->QueryInterface(IID_IMediaEventEx, (void **)&pME); 　hr = pGB->RenderFile(lpszMovie, NULL); 　hr = pMC->Run(); 　hr = pME->WaitForCompletion(INFINITE, &evCode); 　if(pMC)pMC->Release(); 　if(pGB)pGB->Release(); 　if(pME)pME->Release(); }

　　上述代码中，CoCreateInstance（）函数创建了一个过滤器图表（Filter Graph）对象，并返回一个媒体控制（ImediaControl）接口，这个接口通过过滤器来实现播放、暂停、停止等媒体放映功能，但是这时候图表对象并不包含具体的过滤器，因为此时DirectX并不清楚需要播放何种类型的媒体；接下来创建一个图表构建接口，该接口可以实现创建过滤器图表、向图表对象添加、删除各种过滤器、列举当前过滤器图表中所有的过滤器、连接图表对象中的各个过滤器等功能；本例中使用了IGraphBuilder 接口的RenderFile（）函数，告诉DirectX需要播放的媒体文件名，此时IgraphBuilder对象接口根据多媒体文件的类型，自动向过滤器图表添加播放该类型媒体所需的的各种过滤器，并实现其连接。

　　最后，函数调用ImediaControl接口对象的Run()函数，就可以开始播放媒体文件了。为了实现从头至尾的顺序播放完多媒体文件，需要调用IMediaEventEx 对象接口的WaitForCompletion（）阻塞函数的运行，直到媒体文件结束后才可以释放对象、结束函数的运行。 

 

完整示例

#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; 
    } 
//IMediaControl 用于控制数据流。它提供停止和开始的操作方法

//IMediaEvent   可以获得Filter Graph Manager 事件。例如，可以获得播放完成事件
    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); 

//当过滤器图表开始运行，数据从通过过滤器播放出来。播放动作将在一个独立的线程中进行。调用

//IMediaEvent::WaitForCompletion 方法可以等待文件播放完成。 
        } 
    } 
    pControl->Release(); 
    pEvent->Release(); 
    pGraph->Release(); 
    CoUninitialize(); 

}

 

directshow中响应事件

EC_ACTIVATE 视频窗口被激活或者转为非激活状态
EC_BUFFERING_DATA 过滤图形包含缓冲数据
EC_CLOCK_CHANGED 参考时钟被改变
EC_CLOCK_UNSET 时钟提供者被断开
EC_COMPLETE 所有数据被渲染完毕
EC_DEVICE_LOST 一个即插即用设备被移除或者变为有效.
EC_DISPLAY_CHANGED 显示模式被改变
EC_END_OF_SEGMENT 到达段的末尾.
EC_ERROR_STILLPLAYING 一个异步命令失败
EC_ERRORABORT 一个操作被放弃
EC_EXTDEVICE_MODE_CHANGE 不支持
EC_FULLSCREEN_LOST 一个视频渲染窗口被切换出全屏模式.
EC_GRAPH_CHANGED 过滤器图被改变
EC_LENGTH_CHANGED 源的长度被改变.
EC_NEED_RESTART 过滤器请求过滤图重新开始.
EC_NOTIFY_WINDOW 通报一个视频渲染窗口的过滤器
EC_OLE_EVENT 过滤器传递一个字符串给应用程序。.
EC_OPENING_FILE 过滤图打开一个文件，或者已经完成了打开文件操作
EC_PALETTE_CHANGED 视频调色板被改变.
EC_PAUSED 一个暂停请求被处理.
EC_QUALITY_CHANGE 过滤图为了质量控制丢桢
EC_REPAINT 一个视频渲染器要求重绘.
EC_SEGMENT_STARTED 一个新段开始
EC_SHUTTING_DOWN 过滤器图被关闭
EC_SNDDEV_IN_ERROR 一个音频设备的输入引脚错误.
EC_SNDDEV_OUT_ERROR 一个音频设备的输出引脚错误.
EC_STARVATION 过滤器没有得到足够的数据.
EC_STATE_CHANGE 过滤器图状态改变
EC_STEP_COMPLETE 一个过滤器执行了单桢渐进
EC_STREAM_CONTROL_STARTED 流控制开始命令产生效果.
EC_STREAM_CONTROL_STOPPED 一个流控制的停止命令产生效果
EC_STREAM_ERROR_STILLPLAYING 在流中产生了一个错误，但流还是在运行中.
EC_STREAM_ERROR_STOPPED 一个流因错误而停止
EC_TIMECODE_AVAILABLE 不支持
EC_USERABORT 用户中断回放.
EC_VIDEO_SIZE_CHANGED 本地视频尺寸改变.
EC_WINDOW_DESTROYED 视频渲染器被销毁，或者从过滤器图中移除.

下面的例子代码处理了一个来自主窗口的消息循环。这个消息是用户自己定义的，WM_APP是一个用户消息的底线标志，应用程序可以使用的消息标识的数字范围是WM_APP到0xBFFF。如下：
#define WM_GRAPHNOTIFY  WM_APP + 1
下来设定过滤图形管理器来给应用程序的主窗口提交这个消息：
pEvent->SetNotifyWindow((OAHWND)g_hwnd, WM_GRAPHNOTIFY, 0);
ImediaEventEx::SetNotifyWindow方法指定了一个窗口（g_hwnd）作为接收消息的容器。这个方法需要在创建完过滤图形管理器和指定播放窗口之后调用，但一定要在播放之前。
为了响应消息我们需要在WindowProc中添加这个消息的处理：
case WM_GRAPHNOTIFY:
    HandleEvent();
    break;
在处理函数中我们可以调用ImediaEvent::GetEvent方法来从循环中获得事件：
long evCode, param1, param2;
HRESULT hr;
if (pEvent == NULL)
    return;
while (hr = pEvent->GetEvent(&evCode, &param1, &param2, 0), SUCCEEDED(hr))
{
    hr = pEvent->FreeEventParams(evCode, param1, param2);
    if ((EC_COMPLETE == evCode) || (EC_USERABORT == evCode))
    { 
        CleanUp();
        break;
    } 
}
因为事件是异步处理的，因此可能会有很多消息需要处理，我们要一直调用GetEvent来获得消息，直到它的返回值为失败码，这样就证明消息信号已经空了。
由于它们的参数有可能会是BSTR类型的数据（这是ATL里需要分配资源的数据类型）。因此我们要释放它们（ImediaEvent::FreeEventParams）。
当一个EC_COMPLETE事件发生，过滤图形管理器不会自动的切换到停止状态。这个必须由应用程序来控制。
在应用程序释放ImediaEventEx指针的时候，它必须要设置SetNotifyWindow为NULL来取消事件通报。
pEvent->SetNotifyWindow(NULL, 0, 0);
pEvent->Release();
pEvent = NULL;
下面是一个完整的例子：
#include <windows.h>
#include <dshow.h>

#define WM_GRAPHNOTIFY  WM_APP + 1
#define CLASSNAME "EventNotify"

IGraphBuilder   *pGraph = NULL;
IMediaControl   *pMediaControl = NULL;
IMediaEventEx   *pEvent = NULL;
IVideoWindow    *pVidWin = NULL;
HWND            g_hwnd;

void PlayFile(void)
{
    CoCreateInstance(CLSID_FilterGraph, NULL, CLSCTX_INPROC,
                     IID_IGraphBuilder, (void **)&pGraph);
    pGraph->RenderFile(L"C:\\Media\\Boys.avi", NULL);

    pGraph->QueryInterface(IID_IVideoWindow, (void **)&pVidWin);
    pVidWin->put_Owner((OAHWND)g_hwnd);
    pVidWin->put_WindowStyle( WS_CHILD | WS_CLIPSIBLINGS);

    pGraph->QueryInterface(IID_IMediaEventEx, (void **)&pEvent);
    pEvent->SetNotifyWindow((OAHWND)g_hwnd, WM_GRAPHNOTIFY, 0);

    pGraph->QueryInterface(IID_IMediaControl, (void **)&pMediaControl);
    pMediaControl->Run();
}

void CleanUp(void)
{
    pVidWin->put_Visible(OAFALSE);
    pVidWin->put_Owner(NULL);

    pEvent->SetNotifyWindow(NULL, 0, 0);
    pEvent->Release();
    pEvent = NULL;

    // Stop the graph.
    pMediaControl->Stop();

    pMediaControl->Release();
    pVidWin->Release();
    pGraph->Release();
    PostQuitMessage(0);
}

void HandleEvent() 
{
    long evCode, param1, param2;
    HRESULT hr;

    if (pEvent == NULL) 
        return;

    while (hr = pEvent->GetEvent(&evCode, &param1, &param2, 0), SUCCEEDED(hr))
    { 
        hr = pEvent->FreeEventParams(evCode, param1, param2);
        if ((EC_COMPLETE == evCode) || (EC_USERABORT == evCode))
        { 
            CleanUp();
            break;
        } 
    } 
}

/* WindowProc 函数在这里:
        case WM_GRAPHNOTIFY:
            HandleEvent();
            break;