MFP_EVENT_TYPE列挙 (mfplay.h)

大事な 廃止。 この API は、Windows の今後のリリースから削除される可能性があります。 アプリケーションでは、再生に メディア セッション を使用する必要があります。

 

IMFPMediaPlayerCallback インターフェイスのイベントの種類を定義します。

構文

typedef enum MFP_EVENT_TYPE {
  MFP_EVENT_TYPE_PLAY = 0,
  MFP_EVENT_TYPE_PAUSE = 1,
  MFP_EVENT_TYPE_STOP = 2,
  MFP_EVENT_TYPE_POSITION_SET = 3,
  MFP_EVENT_TYPE_RATE_SET = 4,
  MFP_EVENT_TYPE_MEDIAITEM_CREATED = 5,
  MFP_EVENT_TYPE_MEDIAITEM_SET = 6,
  MFP_EVENT_TYPE_FRAME_STEP = 7,
  MFP_EVENT_TYPE_MEDIAITEM_CLEARED = 8,
  MFP_EVENT_TYPE_MF = 9,
  MFP_EVENT_TYPE_ERROR = 10,
  MFP_EVENT_TYPE_PLAYBACK_ENDED = 11,
  MFP_EVENT_TYPE_ACQUIRE_USER_CREDENTIAL = 12
} ;

定数

MFP_EVENT_TYPE_PLAY 値: 0 再生が開始されました。 このイベントは、 IMFPMediaPlayer::P lay メソッドが完了したときに送信されます。
MFP_EVENT_TYPE_PAUSE 値: 1 再生が一時停止しました。 このイベントは、 IMFPMediaPlayer::P ause メソッドが完了したときに送信されます。
MFP_EVENT_TYPE_STOP 値: 2 再生が停止しました。 このイベントは、 IMFPMediaPlayer::Stop メソッドの完了時に送信されます。
MFP_EVENT_TYPE_POSITION_SET 値: 3 MFPlay プレーヤー オブジェクトは、新しい再生位置をシークしました。 このイベントは、 IMFPMediaPlayer::SetPosition メソッドが完了したときに送信されます。
MFP_EVENT_TYPE_RATE_SET 値: 4 再生速度が変更されました。 このイベントは、 IMFPMediaPlayer::SetRate メソッドが完了したときに送信されます。
MFP_EVENT_TYPE_MEDIAITEM_CREATED 値: 5 新しいメディア項目が作成されました。 このイベントは、 IMFPMediaPlayer::CreateMediaItemFromURL メソッドまたは CreateMediaItemFromObject メソッドが完了したときに送信されます。
MFP_EVENT_TYPE_MEDIAITEM_SET 値: 6 メディア項目を再生する準備ができました。 このイベントは、 IMFPMediaPlayer::SetMediaItem メソッドが完了したときに送信されます。
MFP_EVENT_TYPE_FRAME_STEP 値: 7 フレーム ステップ操作が完了しました。 このイベントは、 IMFPMediaPlayer::FrameStep メソッドが完了したときに送信されます。
MFP_EVENT_TYPE_MEDIAITEM_CLEARED 値: 8 現在のメディア項目がクリアされました。 このイベントは、 IMFPMediaPlayer::ClearMediaItem メソッドが完了したときに送信されます。
MFP_EVENT_TYPE_MF 値: 9 パイプライン オブジェクトがイベントを送信しました。 プレーヤー オブジェクトは、特定のパイプライン イベントをアプリケーションに転送します。 詳細については、「 MFP_MF_EVENT」を参照してください。
MFP_EVENT_TYPE_ERROR 値: 10 再生エラーが発生した。
MFP_EVENT_TYPE_PLAYBACK_ENDED 値: 11 再生が終了しました。 プレーヤー オブジェクトは、再生がメディア ファイルの末尾に達すると、このイベントを送信します。
MFP_EVENT_TYPE_ACQUIRE_USER_CREDENTIAL 値: 12 メディア ソースでは、ファイルを再生する前に認証が必要です。

注釈

イベントの種類ごとに、 IMFPMediaPlayerCallback::OnMediaPlayerEvent コールバックはデータ構造へのポインターを受け取ります。 データ構造の最初の部分は、常に MFP_EVENT_HEADER 構造体です。 次の表に、各イベントの種類のデータ構造を示します。

OnMediaPlayerEvent の実装では、pEventHeader パラメーターを正しい構造体の種類にキャストする必要があります。 この目的のためにマクロのセットが定義されています。 これらのマクロは、イベント型の値をチェックし、不一致がある場合は NULL を返します。それ以外の場合は、正しい構造体型へのポインターを返します。

イベントの種類	イベント構造 ポインター キャスト マクロ
MFP_EVENT_TYPE_PLAY	MFP_PLAY_EVENT MFP_GET_PLAY_EVENT
MFP_EVENT_TYPE_PAUSE	MFP_PAUSE_EVENT MFP_GET_PAUSE_EVENT
MFP_EVENT_TYPE_STOP	MFP_STOP_EVENT MFP_GET_STOP_EVENT
MFP_EVENT_TYPE_POSITION_SET	MFP_POSITION_SET_EVENT MFP_GET_POSITION_SET_EVENT
MFP_EVENT_TYPE_RATE_SET	MFP_RATE_SET_EVENT MFP_GET_RATE_SET_EVENT
MFP_EVENT_TYPE_MEDIAITEM_CREATED	MFP_MEDIAITEM_CREATED_EVENT MFP_GET_MEDIAITEM_CREATED_EVENT
MFP_EVENT_TYPE_MEDIAITEM_SET	MFP_MEDIAITEM_SET_EVENT MFP_GET_MEDIAITEM_SET_EVENT
MFP_EVENT_TYPE_FRAME_STEP	MFP_FRAME_STEP_EVENT MFP_GET_FRAME_STEP_EVENT
MFP_EVENT_TYPE_MEDIAITEM_CLEARED	MFP_MEDIAITEM_CLEARED_EVENT MFP_GET_MEDIAITEM_CLEARED_EVENT
MFP_EVENT_TYPE_MF	MFP_MF_EVENT MFP_GET_MF_EVENT
MFP_EVENT_TYPE_ERROR	MFP_ERROR_EVENT MFP_GET_ERROR_EVENT
MFP_EVENT_TYPE_PLAYBACK_ENDED	MFP_PLAYBACK_ENDED_EVENT MFP_GET_PLAYBACK_ENDED_EVENT
MFP_EVENT_TYPE_ACQUIRE_USER_CREDENTIAL	MFP_ACQUIRE_USER_CREDENTIAL_EVENT MFP_GET_ACQUIRE_USER_CREDENTIAL_EVENT

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップ アプリのみ]
Header	mfplay.h

こちらもご覧ください

IMFPMediaPlayerCallback

Media Foundation 列挙