イベントへの応答

[アーティクル]
06/21/2023

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオキャプチャに置き換わりました。これらの機能は、Windows 10とWindows 11用に最適化されています。新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

この記事では、フィルターグラフで発生するイベントに応答する方法について説明します。

イベント通知のしくみ

DirectShow アプリケーションの実行中は、フィルターグラフ内でイベントが発生する可能性があります。たとえば、フィルターでストリーミングエラーが発生する可能性があります。フィルターは、イベントコードと 2 つのイベントパラメーターで構成されるイベントを送信することで、Graph Manager をフィルター処理することでアラートを生成します。イベントコードはイベントの種類を示し、イベントパラメーターは追加情報を提供します。パラメーターの意味は、イベントコードによって異なります。イベントコードの完全な一覧については、「イベント通知コード」を参照してください。

一部のイベントは、アプリケーションに通知されずに、フィルターグラフマネージャーによってサイレント処理されます。その他のイベントは、アプリケーションのキューに配置されます。アプリケーションによっては、さまざまなイベントを処理する必要があります。この記事では、非常に一般的な 3 つのイベントについて説明します。

EC_COMPLETE イベントは、再生が正常に完了したことを示します。
EC_USERABORT イベントは、ユーザーが再生を中断したことを示します。ビデオレンダラーは、ユーザーがビデオウィンドウを閉じると、このイベントを送信します。
EC_ERRORABORT イベントは、エラーによって再生が停止したことを示します。

イベント通知の使用

アプリケーションは、新しいイベントが発生するたびに、指定されたウィンドウに Windows メッセージを送信するようにフィルターグラフマネージャーに指示できます。これにより、アプリケーションはウィンドウのメッセージループ内で応答できます。まず、アプリケーションウィンドウに送信されるメッセージを定義します。アプリケーションでは、WM_APPから0xBFFFまでの範囲のメッセージ番号をプライベートメッセージとして使用できます。

#define WM_GRAPHNOTIFY  WM_APP + 1

次に、フィルターグラフマネージャーに IMediaEventEx インターフェイスのクエリを実行し、 IMediaEventEx::SetNotifyWindow メソッドを呼び出します。

IMediaEventEx *g_pEvent = NULL;
g_pGraph->QueryInterface(IID_IMediaEventEx, (void **)&g_pEvent);
g_pEvent->SetNotifyWindow((OAHWND)g_hwnd, WM_GRAPHNOTIFY, 0);

このメソッドは、指定したウィンドウ (g_hwnd) をメッセージの受信者として指定します。フィルターグラフを作成した後、グラフを実行する前にメソッドを呼び出します。

WM_GRAPHNOTIFYは通常の Windows メッセージです。 Filter Graph Manager は、イベントキューに新しいイベントを配置するたびに、指定されたアプリケーションウィンドウにWM_GRAPHNOTIFYメッセージを投稿します。メッセージの lParam パラメーターは 、SetNotifyWindow の 3 番目のパラメーターと同じです。このパラメーターを使用すると、メッセージと共にインスタンスデータを送信できます。ウィンドウメッセージの wParam パラメーターは常に 0 です。

アプリケーションの WindowProc 関数で、WM_GRAPHNOTIFY メッセージの case ステートメントを追加します。

case WM_GRAPHNOTIFY:
    HandleGraphEvent();
    break;

イベントハンドラー関数で、 IMediaEvent::GetEvent メソッドを呼び出して、キューからイベントを取得します。

void HandleGraphEvent()
{
    // Disregard if we don't have an IMediaEventEx pointer.
    if (g_pEvent == NULL)
    {
        return;
    }
    // Get all the events
    long evCode;
    LONG_PTR param1, param2;
    HRESULT hr;
    while (SUCCEEDED(g_pEvent->GetEvent(&evCode, &param1, &param2, 0)))
    {
        g_pEvent->FreeEventParams(evCode, param1, param2);
        switch (evCode)
        {
        case EC_COMPLETE:  // Fall through.
        case EC_USERABORT: // Fall through.
        case EC_ERRORABORT:
            CleanUp();
            PostQuitMessage(0);
            return;
        }
    } 
}

GetEvent メソッドは、イベントコードと 2 つのイベントパラメーターを取得します。 4 番目の GetEvent パラメーターは、イベントを待機する時間をミリ秒単位で指定します。アプリケーションは、WM_GRAPHNOTIFY メッセージに応答してこのメソッドを呼び出すので、イベントは既にキューに登録されています。そのため、タイムアウト値を 0 に設定します。

イベント通知とメッセージループはどちらも非同期であるため、アプリケーションがメッセージに応答する時点までにキューに複数のイベントが保持される可能性があります。また、フィルターグラフマネージャーは、無効になった場合にキューから特定のイベントを削除できます。そのため、キューが空であることを示すエラーコードが返されるまで 、GetEvent を呼び出す必要があります。

この例では、アプリケーションがアプリケーション定義の CleanUp 関数を呼び出して、EC_COMPLETE、 EC_USERABORT、 およびEC_ERRORABORT に応答します。これにより、アプリケーションが正常に終了します。この例では、2 つのイベントパラメーターは無視されます。イベントを取得したら、イベントパラメーターに関連付けられている空きリソースに IMediaEvent::FreeEventParams を呼び出します。

EC_COMPLETE イベントによってフィルターグラフが停止しないことに注意してください。アプリケーションは、グラフを停止または一時停止できます。グラフを停止すると、フィルターによって保持されているリソースが解放されます。グラフを一時停止すると、フィルターは引き続きリソースを保持します。また、ビデオレンダラーが一時停止すると、最新のフレームの静的イメージが表示されます。

IMediaEventEx ポインターを解放する前に、NULL ウィンドウハンドルを使用して SetNotifyWindow を呼び出してイベント通知を取り消します。

// Disable event notification before releasing the graph.
g_pEvent->SetNotifyWindow(NULL, 0, 0);
g_pEvent->Release();
g_pEvent = NULL;

WM_GRAPHNOTIFY メッセージハンドラーで、GetEvent を呼び出す前に IMediaEventEx ポインターをチェックします。

if (g_pEvent == NULL) return;

これにより、アプリケーションがポインターを解放した後にイベント通知を受け取った場合に発生する可能性のあるエラーが回避されます。

DirectShow の基本的なタスク
DirectShow でのイベント通知

次の方法で共有

イベントへの応答

イベント通知のしくみ

イベント通知の使用

フィードバック

その他のリソース

次の方法で共有

イベントへの応答

イベント通知のしくみ

イベント通知の使用

関連トピック

フィードバック

その他のリソース