6. DirectShow-事件和事件响应

事件的消息队列机制

filter通过发布事件通知来通知 Filter Graph 管理器有关事件。 该事件可能是预期事件(例如流的末尾),也可能表示错误,例如无法呈现流。 Filter Graph 管理器自行处理某些filter事件,而其他filter事件则留给应用程序处理。 如果 Filter Graph 管理器不处理filter事件,则会将事件通知放入队列中。 filter图还可以为应用程序将自己的事件通知排队。

应用程序从队列中检索事件,并根据事件类型对其进行响应。 因此,DirectShow 中的事件通知类似于 Microsoft Windows 消息队列方案。 应用程序还可以取消filter关系图管理器对给定事件类型的默认行为。 然后,Filter Graph 管理器将这些事件直接放入队列中供应用程序处理。

  • 用于与应用程序通信的 Filter Graph 管理器。
  • 用于与应用程序和filter关系图管理器通信的filter
  • 应用程序,以确定其在处理事件中的参与程度。

Filter Graph 管理器公开三个支持事件通知的接口。

  • IMediaEventSink 包含用于发布事件的filter的方法。
  • IMediaEvent 包含应用程序用于检索事件的方法。
  • IMediaEventEx 继承自 并扩展 IMediaEvent 接口。
    通过在 Filter Graph 管理器上调用 IMediaEventSink::Notify 方法筛选事件通知。 事件通知由一个定义事件类型的事件代码和两个提供其他信息的参数组成。 根据事件代码,参数可能包含指针、返回代码、引用时间或其他信息。 有关事件代码和参数的完整列表,请参阅 事件通知代码。

若要从队列中检索事件,应用程序在 Filter Graph Manager 上调用 IMediaEvent::GetEvent 方法。 此方法将阻塞,直到有要返回的事件,或直到指定的时间过去。 假设存在排队事件,该方法返回事件代码和两个事件参数。 调用 GetEvent 后,应用程序应始终调用 IMediaEvent::FreeEventParams 方法,以释放与事件参数关联的任何资源。 例如,参数可能是由filter图分配的 BSTR 值。

下面的代码示例概述了如何从队列中检索事件。

long evCode;
LONG_PTR param1, param2;
HRESULT hr;
while (hr = pEvent->GetEvent(&evCode, &param1, &param2, 0), SUCCEEDED(hr))
{
    switch(evCode) 
    { 
        // Call application-defined functions for each 
        // type of event that you want to handle.
    } 
    hr = pEvent->FreeEventParams(evCode, param1, param2);
}

若要替代 Filter Graph 管理器对事件的默认处理,请使用事件代码作为参数调用 IMediaEvent::CancelDefaultHandling 方法。 可以通过调用 IMediaEvent::RestoreDefaultHandling 方法来恢复默认处理。 如果filter图未对指定的事件代码执行默认处理,则调用这些方法不起作用。

事件的两种响应机制

若要处理 DirectShow 事件,应用程序需要一种方法来查明事件何时在队列中等待。 Filter Graph 管理器提供了两种执行此操作的方法:

  • 窗口通知: 每当有新事件时,Filter Graph 管理器会将用户定义的 Windows 消息发送到应用程序窗口。
  • 事件信号: 如果队列中有 DirectShow 事件,Filter Graph 管理器会发出 Windows 事件信号,如果队列为空,则重置事件。

应用程序可以使用任一技术。 窗口通知通常更简单。

窗口通知

若要设置窗口通知,请调用 IMediaEventEx::SetNotifyWindow 方法并指定私人消息。 应用程序可以使用从WM_APP到0xBFFF范围内的消息号作为私人消息。 每当 Filter Graph 管理器在队列中放置新事件通知时,它会将此消息发布到指定的窗口。 应用程序从窗口的消息循环中响应消息。

下面的代码示例演示如何设置通知窗口。

#define WM_GRAPHNOTIFY WM_APP + 1   // Private message.
pEvent->SetNotifyWindow((OAHWND)g_hwnd, WM_GRAPHNOTIFY, 0);

该消息是普通的 Windows 消息,独立于 DirectShow 事件通知队列发布。 此方法的优点是大多数应用程序已实现消息循环。 因此,无需执行大量额外工作即可合并 DirectShow 事件处理。

下面的代码示例演示了如何响应通知消息的概述。 有关完整示例,请参阅 响应事件。

LRESULT CALLBACK WindowProc( HWND hwnd, UINT msg, UINT wParam, LONG lParam)
{
    switch (msg)
    {
        case WM_GRAPHNOTIFY:
            HandleEvent();  // Application-defined function.
            break;
        // Handle other Windows messages here too.
    }
    return (DefWindowProc(hwnd, msg, wParam, lParam));
}

由于事件通知和消息循环都是异步的,因此在应用程序响应消息时,队列可能包含多个事件。 此外,如果事件变得无效,有时可以从队列中清除这些事件。 因此,在事件处理代码中,调用 IAMMediaEvent::GetEvent ,直到返回失败代码,指示队列为空。

在释放 IMediaEventEx 指针之前,请使用 NULL 指针调用 SetNotifyWindow 来取消事件通知。 在事件处理代码中,检查 IMediaEventEx 指针在调用 GetEvent 之前是否有效。 这些步骤可防止可能出现的错误,即应用程序在释放 IMediaEventEx 指针后接收事件通知。

事件信号

Filter Graph 管理器保留一个反映事件队列状态的手动重置事件。 如果队列包含挂起的事件通知,Filter Graph 管理器会发出手动重置事件的信号。 如果队列为空,则对 IMediaEvent::GetEvent 方法的调用将重置事件。 应用程序可以使用此事件来确定队列的状态。

备注

此处的术语可能会令人困惑。 手动重置事件是由 Windows CreateEvent 函数创建的事件类型, 它与 DirectShow 定义的事件无关。

调用 IMediaEvent::GetEventHandle 方法以获取手动重置事件的句柄。 等待通过调用 WaitForMultipleObjects 等函数发出事件信号。 发出事件信号后,调用 IMediaEvent::GetEvent 以获取 DirectShow 事件。

以下代码示例演示了此方法。 它获取事件句柄,然后以 100 毫秒的间隔等待事件发出信号。 如果事件收到信号,它将调用 GetEvent 并将事件代码和事件参数输出到控制台窗口。 循环在 发生EC_COMPLETE 事件时终止,指示播放已完成。

HANDLE  hEvent; 
long    evCode, param1, param2;
BOOLEAN bDone = FALSE;
HRESULT hr = S_OK;
hr = pEvent->GetEventHandle((OAEVENT*)&hEvent);
if (FAILED(hr))
{
    /* Insert failure-handling code here. */
}

while(!bDone) 
{
    if (WAIT_OBJECT_0 == WaitForSingleObject(hEvent, 100))
    { 
        while (S_OK == pEvent->GetEvent(&evCode, &param1, &param2, 0)) 
        {
            printf("Event code: %#04x\n Params: %d, %d\n", evCode, param1, param2);
            pEvent->FreeEventParams(evCode, param1, param2);
            bDone = (EC_COMPLETE == evCode);
        }
    }
} 

由于filter图会在适当时自动设置或重置事件,因此应用程序不应这样做。 此外,释放filter图时,filter图将关闭事件句柄,因此不要在该点之后使用事件句柄。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 211,743评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,296评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,285评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,485评论 1 283
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,581评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,821评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,960评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,719评论 0 266
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,186评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,516评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,650评论 1 340
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,329评论 4 330
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,936评论 3 313
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,757评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,991评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,370评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,527评论 2 349

推荐阅读更多精彩内容