IMFMediaEventGenerator::GetEvent メソッド (mfobjects.h)

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

構文

HRESULT GetEvent(
  [in]  DWORD         dwFlags,
  [out] IMFMediaEvent **ppEvent
);

[in] dwFlags

次のいずれかの値を指定します。

値	意味
0	メソッドは、イベントジェネレーターがイベントをキューに入れるまでブロックします。
MF_EVENT_FLAG_NO_WAIT	メソッドは直ちにを返します。

[out] ppEvent

IMFMediaEvent インターフェイスへのポインターを受け取ります。呼び出し元はインターフェイスを解放する必要があります。

このメソッドは HRESULT を返します。有効な値を次の表に示しますが、これ以外にもあります。

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

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

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

このメソッドは、以前に IMFMediaEventGenerator::BeginGetEvent を呼び出し、まだ IMFMediaEventGenerator::EndGetEvent を呼び出していない場合に、MF_E_MULTIPLE_SUBSCRIBERSを返します。

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	mfobjects.h (Mfidl.h を含む)
Library	Mfuuid.lib