响应事件
这里我们讲解在文件播放中怎样响应事件。后面将提供大概25行新代码来说明这个问题。
首先我们先讲讲事件通报是怎样工作的
在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 视频渲染器被销毁,或者从过滤器图中移除.
过滤图形管理器有时候处理一些事件并不通报给应用程序,例如,请求重绘视频窗口的事件。DirectShow的事件响应机制很象Windows下的消息循环。其实当一个新的事件发生时,你可以发送一个windows消息到指定的窗口。然后应用程序会从windows消息循环中处理这个事件。
使用事件通报
下面的例子代码处理了一个来自主窗口的消息循环。这个消息是用户自己定义的,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, ¶m1, ¶m2, 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, ¶m1, ¶m2, 0), SUCCEEDED(hr))
{
hr = pEvent->FreeEventParams(evCode, param1, param2);
if ((EC_COMPLETE == evCode) || (EC_USERABORT == evCode))
{
CleanUp();
break;
}
}
}
/* WindowProc 函数在这里:
case WM_GRAPHNOTIFY:
HandleEvent();
break;