MFP_EVENT_TYPE列舉 (mfplay.h)

重要 廢棄。 此 API 可能會從未來的 Windows 版本中移除。 應用程式應該使用 媒體會話 播放。

 

定義 IMFPMediaPlayerCallback 介面的事件類型。

Syntax

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 [僅限傳統型應用程式]
標頭	mfplay.h

另請參閱

IMFPMediaPlayerCallback

媒體基礎列舉