(mfplay.h) MFP_MF_EVENT 结构

  • 项目
重要 废弃。 此 API 可能会从 Windows 的未来版本中删除。 应用程序应使用 媒体会话 进行播放。
 

MFP_EVENT_TYPE_MF 事件的事件结构。 MFPlay 播放器对象使用此事件将某些事件从媒体基础管道转发到应用程序。

语法

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

成员

header

MFP_EVENT_HEADER 结构，其中包含所有 IMFPMediaPlayer 事件共有的数据。

MFEventType

媒体基础事件类型。 目前，MFPlay 播放器对象将以下管道事件转发到应用程序：

事件 说明
MEBufferingStarted 源已开始缓冲数据。
MEBufferingStopped 源已停止缓冲数据。
MEExtendedType 自定义事件类型。
MEReconnectEnd 源已完成重新连接到服务器的尝试。
MEReconnectStart 源正在尝试重新连接到服务器。
MERendererEvent 呈现器发送的事件，例如 增强的视频呈现器 (EVR) 。
MEStreamSinkFormatChanged 流格式已更改。

pMFMediaEvent

指向媒体基础事件的 IMFMediaEvent 接口的指针。

pMediaItem

指向当前媒体项的 IMFPMediaItem 接口的指针。

注解

若要获取指向此结构的指针，请强制转换 IMFPMediaPlayerCallback：：OnMediaPlayerEvent 方法的 pEventHeader 参数。 可以使用 MFP_GET_MF_EVENT 宏实现此目的。

如果 MFEventType 为 MEStreamSinkFormatChanged，则以下属性可能存储在事件属性存储中，可通过 header.pPropertyStore 成员访问该属性存储区。

属性 说明
MFP_PKEY_StreamIndex 格式已更改的流的索引。

要求

要求 值
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
标头 mfplay.h

另请参阅

IMFPMediaPlayerCallback

媒体基础结构

使用 MFPlay 播放音频/视频