MF_MEDIA_ENGINE_EVENT列挙 (mfmediaengine.h)

  • [アーティクル]

メディア エンジンのイベント コードを定義します。

構文

typedef enum MF_MEDIA_ENGINE_EVENT {
  MF_MEDIA_ENGINE_EVENT_LOADSTART = 1,
  MF_MEDIA_ENGINE_EVENT_PROGRESS = 2,
  MF_MEDIA_ENGINE_EVENT_SUSPEND = 3,
  MF_MEDIA_ENGINE_EVENT_ABORT = 4,
  MF_MEDIA_ENGINE_EVENT_ERROR = 5,
  MF_MEDIA_ENGINE_EVENT_EMPTIED = 6,
  MF_MEDIA_ENGINE_EVENT_STALLED = 7,
  MF_MEDIA_ENGINE_EVENT_PLAY = 8,
  MF_MEDIA_ENGINE_EVENT_PAUSE = 9,
  MF_MEDIA_ENGINE_EVENT_LOADEDMETADATA = 10,
  MF_MEDIA_ENGINE_EVENT_LOADEDDATA = 11,
  MF_MEDIA_ENGINE_EVENT_WAITING = 12,
  MF_MEDIA_ENGINE_EVENT_PLAYING = 13,
  MF_MEDIA_ENGINE_EVENT_CANPLAY = 14,
  MF_MEDIA_ENGINE_EVENT_CANPLAYTHROUGH = 15,
  MF_MEDIA_ENGINE_EVENT_SEEKING = 16,
  MF_MEDIA_ENGINE_EVENT_SEEKED = 17,
  MF_MEDIA_ENGINE_EVENT_TIMEUPDATE = 18,
  MF_MEDIA_ENGINE_EVENT_ENDED = 19,
  MF_MEDIA_ENGINE_EVENT_RATECHANGE = 20,
  MF_MEDIA_ENGINE_EVENT_DURATIONCHANGE = 21,
  MF_MEDIA_ENGINE_EVENT_VOLUMECHANGE = 22,
  MF_MEDIA_ENGINE_EVENT_FORMATCHANGE = 1000,
  MF_MEDIA_ENGINE_EVENT_PURGEQUEUEDEVENTS = 1001,
  MF_MEDIA_ENGINE_EVENT_TIMELINE_MARKER = 1002,
  MF_MEDIA_ENGINE_EVENT_BALANCECHANGE = 1003,
  MF_MEDIA_ENGINE_EVENT_DOWNLOADCOMPLETE = 1004,
  MF_MEDIA_ENGINE_EVENT_BUFFERINGSTARTED = 1005,
  MF_MEDIA_ENGINE_EVENT_BUFFERINGENDED = 1006,
  MF_MEDIA_ENGINE_EVENT_FRAMESTEPCOMPLETED = 1007,
  MF_MEDIA_ENGINE_EVENT_NOTIFYSTABLESTATE = 1008,
  MF_MEDIA_ENGINE_EVENT_FIRSTFRAMEREADY = 1009,
  MF_MEDIA_ENGINE_EVENT_TRACKSCHANGE = 1010,
  MF_MEDIA_ENGINE_EVENT_OPMINFO = 1011,
  MF_MEDIA_ENGINE_EVENT_RESOURCELOST = 1012,
  MF_MEDIA_ENGINE_EVENT_DELAYLOADEVENT_CHANGED = 1013,
  MF_MEDIA_ENGINE_EVENT_STREAMRENDERINGERROR = 1014,
  MF_MEDIA_ENGINE_EVENT_SUPPORTEDRATES_CHANGED = 1015,
  MF_MEDIA_ENGINE_EVENT_AUDIOENDPOINTCHANGE = 1016
} ;

定数

 
MF_MEDIA_ENGINE_EVENT_LOADSTART
値: 1
メディア エンジンがソースの読み込みを開始しました。 「IMFMediaEngine::Load」を参照してください。
MF_MEDIA_ENGINE_EVENT_PROGRESS
値: 2
メディア エンジンがソースを読み込んでいます。
MF_MEDIA_ENGINE_EVENT_SUSPEND
値: 3
メディア エンジンが読み込み操作を中断しました。
MF_MEDIA_ENGINE_EVENT_ABORT
値: 4
メディア エンジンによって、進行中の読み込み操作が取り消されました。
MF_MEDIA_ENGINE_EVENT_ERROR
値: 5
エラーが発生しました。














イベント パラメーター説明
param1MF_MEDIA_ENGINE_ERR 列挙体のメンバー。
param2HRESULT エラー コード、または 0。
MF_MEDIA_ENGINE_EVENT_EMPTIED
値: 6
メディア エンジンが MF_MEDIA_ENGINE_NETWORK_EMPTY 状態に切り替わりました。 これは、 IMFMediaEngine::Load メソッドが呼び出されたとき、または Load メソッド中にエラーが発生した場合に発生する可能性があります。 「IMFMediaEngine::GetNetworkState」を参照してください。
MF_MEDIA_ENGINE_EVENT_STALLED
値: 7
読み込みアルゴリズムが停止し、データを待機しています。
MF_MEDIA_ENGINE_EVENT_PLAY
値: 8
メディア エンジンは再生状態に切り替わります。 「IMFMediaEngine::P lay」を参照してください。
MF_MEDIA_ENGINE_EVENT_PAUSE
値: 9
メディア エンジンが一時停止しました。 「IMFMediaEngine::P ause」を参照してください。
MF_MEDIA_ENGINE_EVENT_LOADEDMETADATA
値: 10
メディア エンジンは、ソースの期間とディメンションを決定するのに十分なソース データを読み込んだ。
MF_MEDIA_ENGINE_EVENT_LOADEDDATA
値: 11
メディア エンジンには、コンテンツ (ビデオ フレームなど) をレンダリングするのに十分なデータが読み込まれています。
MF_MEDIA_ENGINE_EVENT_WAITING
値: 12
次のフレームが使用できないため、再生が停止しました。
MF_MEDIA_ENGINE_EVENT_PLAYING
値: 13
再生が開始されました。 「IMFMediaEngine::P lay」を参照してください。
MF_MEDIA_ENGINE_EVENT_CANPLAY
値: 14
再生は開始できますが、メディア エンジンでは、より多くのデータをバッファーに格納するために停止する必要がある場合があります。
MF_MEDIA_ENGINE_EVENT_CANPLAYTHROUGH
値: 15
メディア エンジンは、データのバッファー処理を停止せずに、リソースの最後まで再生できる可能性があります。
MF_MEDIA_ENGINE_EVENT_SEEKING
値: 16
メディア エンジンは、新しい再生位置へのシークを開始しました。 「IMFMediaEngine::SetCurrentTime」を参照してください。
MF_MEDIA_ENGINE_EVENT_SEEKED
値: 17
メディア エンジンは、新しい再生位置を求めています。 「IMFMediaEngine::SetCurrentTime」を参照してください。
MF_MEDIA_ENGINE_EVENT_TIMEUPDATE
値: 18
再生位置が変更されました。 「IMFMediaEngine::GetCurrentTime」を参照してください。
MF_MEDIA_ENGINE_EVENT_ENDED
値: 19
再生がソースの最後に達しました。 GetLoop が TRUE の場合、このイベントは送信されません。
MF_MEDIA_ENGINE_EVENT_RATECHANGE
値: 20
再生速度が変更されました。 「IMFMediaEngine::SetPlaybackRate」を参照してください。
MF_MEDIA_ENGINE_EVENT_DURATIONCHANGE
値: 21
メディア ソースの期間が変更されました。 「IMFMediaEngine::GetDuration」を参照してください。
MF_MEDIA_ENGINE_EVENT_VOLUMECHANGE
値: 22
オーディオ ボリュームが変更されました。 「IMFMediaEngine::SetVolume」を参照してください。
MF_MEDIA_ENGINE_EVENT_FORMATCHANGE
値: 1000
メディア ソースの出力形式が変更されました。














イベント パラメーター説明
param1ビデオ形式が変更された場合は 0、オーディオ形式が変更された場合は 1。
param2ゼロ。
MF_MEDIA_ENGINE_EVENT_PURGEQUEUEDEVENTS
値: 1001
メディア エンジンは、保留中のイベントをキューからフラッシュしました。
MF_MEDIA_ENGINE_EVENT_TIMELINE_MARKER
値: 1002
再生位置がタイムラインマーカーに達しました。 「IMFMediaEngineEx::SetTimelineMarkerTimer」を参照してください。
MF_MEDIA_ENGINE_EVENT_BALANCECHANGE
値: 1003
オーディオバランスが変更されました。 「IMFMediaEngineEx::SetBalance」を参照してください。
MF_MEDIA_ENGINE_EVENT_DOWNLOADCOMPLETE
値: 1004
メディア エンジンはソース データのダウンロードを完了しました。
MF_MEDIA_ENGINE_EVENT_BUFFERINGSTARTED
値: 1005
メディア ソースがデータのバッファー処理を開始しました。
MF_MEDIA_ENGINE_EVENT_BUFFERINGENDED
値: 1006
メディア ソースがデータのバッファリングを停止しました。
MF_MEDIA_ENGINE_EVENT_FRAMESTEPCOMPLETED
値: 1007
IMFMediaEngineEx::FrameStep メソッドが完了しました。
MF_MEDIA_ENGINE_EVENT_NOTIFYSTABLESTATE
値: 1008
メディア エンジンの 読み込み アルゴリズムが開始を待機しています。














イベント パラメーター説明
param1HANDLE 型の待機可能なイベントへの ハンドル。
param2ゼロ。

 

メディア エンジンが MF_MEDIA_ENGINE_WAITFORSTABLE_STATE フラグを使用して作成された場合、メディア エンジンは読み込みアルゴリズムの開始時に MF_MEDIA_ENGINE_EVENT_NOTIFYSTABLESTATE イベントを送信します。 param1 パラメーターは、待機可能なイベントへのハンドルです。 Load スレッドは、アプリケーションが SetEvent を呼び出してイベントを通知するまで待機します。

メディア エンジンが MF_MEDIA_ENGINE_WAITFORSTABLE_STATEで作成されていない場合、このイベントは送信されず、 Load スレッドはシグナルの送信を待機しません。
MF_MEDIA_ENGINE_EVENT_FIRSTFRAMEREADY
値: 1009
メディア ソースの最初のフレームをレンダリングする準備ができました。
MF_MEDIA_ENGINE_EVENT_TRACKSCHANGE
値: 1010
新しいトラックが追加または削除されたときに発生します。

Windows 8.1 以降でサポートされます。
MF_MEDIA_ENGINE_EVENT_OPMINFO
値: 1011
出力保護マネージャー (OPM) に関する新しい情報がある場合に発生します。

このイベントは、OPM エラーが発生したときに発生しますが、ITA は OPM なしでフォールバックを許可します。 この場合、constriction を適用できます。

OPM エラーが発生し、フォールバックも失敗した場合、このイベントは発生しません。 たとえば、OPM を確立できないときに ITA が再生を完全にブロックした場合です。

Windows 8.1 以降でサポートされます。
MF_MEDIA_ENGINE_EVENT_RESOURCELOST
値: 1012
MF_MEDIA_ENGINE_EVENT_DELAYLOADEVENT_CHANGED
値: 1013
MF_MEDIA_ENGINE_EVENT_STREAMRENDERINGERROR
値: 1014
メディア ストリームのいずれかのコンポーネント ストリームが失敗したときに発生します。 このイベントは、メディア ストリームに失敗しなかった他のコンポーネント ストリームが含まれている場合にのみ発生します。
MF_MEDIA_ENGINE_EVENT_SUPPORTEDRATES_CHANGED
値: 1015
MF_MEDIA_ENGINE_EVENT_AUDIOENDPOINTCHANGE
値: 1016

解説

アプリケーションは、 IMFMediaEngineNotify::EventNotify メソッドを介してメディア エンジン イベントを受信します。 EventNotify メソッドには、param1 と param2 の 2 つのイベント パラメーターが含まれています。 パラメーターの意味は、イベント コードによって異なります。 イベントの説明にパラメーターが一覧表示されない場合は、 param1 と param2 の値を無視します。

1000 未満の値は、メディア要素の HTML 5 で定義されているイベントに対応します。

要件

   
サポートされている最小のクライアント Windows 8 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリ |UWP アプリ]
Header mfmediaengine.h

関連項目

IMFMediaEngineNotify::EventNotify

Media Foundation 列挙