IMFMediaEventGenerator

イベントを生成する任意の Media Foundation オブジェクトからイベントを取得します。

このインターフェイスをサポートするオブジェクトは、イベントのキューを保持します。オブジェクトのクライアントは、イベントを同期的にも非同期的にも取得できます。同期メソッドは GetEvent です。非同期メソッドは BeginGetEvent と EndGetEvent です。

キュー内の次のイベントを取得します。このメソッドは同期的です。

このメソッドは HRESULT を返します。取り得る値には、次の表に示すものが含まれますが、これらに限定されません。

このメソッドは同期的に実行されます。

キューに既にイベントが含まれている場合、このメソッドは直ちに S_OK を返します。キューにイベントが含まれていない場合の動作は、dwFlags の値によって異なります。

• dwFlags が 0 の場合、このメソッドは新しいイベントがキューに登録されるか、またはイベントジェネレーターがシャットダウンされるまで、無期限にブロックします。
• dwFlags が MF_EVENT_FLAG_NO_WAIT の場合、このメソッドは戻り値 MF_E_NO_EVENTS_AVAILABLE で直ちに失敗します。

キュー内の次のイベントに対する非同期要求を開始します。

このメソッドは HRESULT を返します。取り得る値には、次の表に示すものが含まれますが、これらに限定されません。

新しいイベントが利用可能になると、イベントジェネレーターは IMFAsyncCallback::Invoke メソッドを呼び出します。Invoke メソッドは IMFMediaEventGenerator::EndGetEvent を呼び出して IMFMediaEvent インターフェイスへのポインターを取得し、そのインターフェイスを使用してイベントを調べる必要があります。

EndGetEvent を呼び出す前に、BeginGetEvent を 2 回目に呼び出さないでください。最初の呼び出しがまだ保留中の間は、同じオブジェクトに対する追加の呼び出しは失敗します。また、非同期要求がまだ保留中の場合、IMFMediaEventGenerator::GetEvent メソッドも失敗します。

例

次のコードは、BeginGetEvent メソッドに対する IMFAsyncCallback::Invoke の典型的な実装を示しています。Invoke メソッドは EndGetEvent を呼び出してイベントデータを取得します。その後、再び BeginGetEvent を呼び出して別のイベントを要求します。

//////////////////////////////////////////////////////////////////////
//  Name: CEventHandler::Invoke
//  Callback for asynchronous BeginGetEvent method.
//
//  pAsyncResult: Pointer to the result.
//
//  This code example assumes that CEventHandler is a class that 
//  implements the IMFAsyncCallback interface. 
///////////////////////////////////////////////////////////////////////
HRESULT CEventHandler::Invoke(IMFAsyncResult *pAsyncResult)
{
    HRESULT hr = S_OK;
    IMFMediaEvent* pEvent = NULL;
    MediaEventType meType = MEUnknown;
    BOOL fGetAnotherEvent = TRUE;
    HRESULT hrStatus = S_OK;

    // Get the event from the event queue.
    // Assume that m_pEventGenerator is a valid pointer to the
    // event generator's IMFMediaEventGenerator interface.
    hr = m_pEventGenerator->EndGetEvent(pAsyncResult, &pEvent);

    // Get the event type.
    if (SUCCEEDED(hr))
    {
        hr = pEvent->GetType(&meType);
    }

    // Get the event status. If the operation that triggered the event 
    // did not succeed, the status is a failure code.
    if (SUCCEEDED(hr))
    {
        hr = pEvent->GetStatus(&hrStatus);
    }

    if (SUCCEEDED(hr))
    {
        // TODO: Handle the event.
    }

    // If not finished, request another event.
    // Pass in a pointer to this instance of the application's
    // CEventHandler class, which implements the callback.
    if (fGetAnotherEvent)
    {
        hr = m_pEventGenerator->BeginGetEvent(this, NULL);
    }

    SAFE_RELEASE(pEvent);
    return hr;
}

キュー内の次のイベントに対する非同期要求を完了します。

このメソッドは HRESULT を返します。取り得る値には、次の表に示すものが含まれますが、これらに限定されません。

このメソッドは、アプリケーションの IMFAsyncCallback::Invoke メソッド内から呼び出します。コード例については、IMFMediaEventGenerator::BeginGetEvent を参照してください。

オブジェクトのキューに新しいイベントを登録します。

このメソッドは HRESULT を返します。取り得る値には、次の表に示すものが含まれますが、これらに限定されません。