MFP_MF_EVENT結構 (mfplay.h)

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

 

MFP_EVENT_TYPE_MF事件的事件結構。 MFPlay player 物件會使用此事件，將特定事件從 Media Foundation 管線轉送到應用程式。

語法

typedef struct MFP_MF_EVENT {
  MFP_EVENT_HEADER header;
  MediaEventType   MFEventType;
  IMFMediaEvent    *pMFMediaEvent;
  IMFPMediaItem    *pMediaItem;
} MFP_MF_EVENT;

成員

header

MFP_EVENT_HEADER 結構，其中包含所有 IMFPMediaPlayer 事件通用的數據。

MFEventType

Media Foundation 事件類型。 目前，MFPlay 播放程式物件會將下列管線事件轉送至應用程式：

事件	描述
MEBufferingStarted	來源已開始緩衝處理數據。
MEBufferingStopped	來源已停止緩衝處理數據。
MEExtendedType	自訂事件類型。
MEReconnectEnd	來源已完成嘗試重新連線到伺服器。
MEReconnectStart	來源嘗試重新連線到伺服器。
MERendererEvent	轉譯器傳送的事件，例如 增強式視訊 轉譯器 (EVR) 。
MEStreamSinkFormatChanged	數據流格式已變更。

pMFMediaEvent

Media Foundation 事件 之 IMFMediaEvent 介面的指標。

pMediaItem

目前媒體專案的 IMFPMediaItem 介面指標。

備註

若要取得這個結構的指標，請轉換 IMFPMediaPlayerCallback：：OnMediaPlayerEvent 方法的 pEventHeader 參數。 您可以使用 MFP_GET_MF_EVENT 宏來進行此用途。

如果 MFEventType 是 MEStreamSinkFormatChanged，下列屬性可能會儲存在事件屬性存放區中，而該存放區可以透過 header.pPropertyStore 成員存取。

屬性	Description
MFP_PKEY_StreamIndex	格式已變更之數據流的索引。

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限桌面應用程式]
標頭	mfplay.h

另請參閱

IMFPMediaPlayerCallback

媒體基礎結構

使用 MFPlay 進行音訊/視訊播放