MFP_MEDIAITEM_CREATED_EVENT结构 (mfplay.h)

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

MFP_EVENT_TYPE_MEDIAITEM_CREATED 事件的事件结构。 当 IMFPMediaPlayer：：CreateMediaItemFromURL 或 IMFPMediaPlayer：：CreateMediaItemFromObject 方法完成时发送此事件。

语法

typedef struct MFP_MEDIAITEM_CREATED_EVENT {
  MFP_EVENT_HEADER header;
  IMFPMediaItem    *pMediaItem;
  DWORD_PTR        dwUserData;
} MFP_MEDIAITEM_CREATED_EVENT;

成员

header

包含 所有 IMFPMediaPlayer 事件通用数据的MFP_EVENT_HEADER结构。

pMediaItem

指向新媒体项的 IMFPMediaItem 接口的指针。 如果创建媒体项失败，则此成员为 NULL。

dwUserData

媒体项的应用程序定义用户数据。 当应用程序调用 CreateMediaItemFromURL 或 CreateMediaItemFromObject 时指定此值。

注解

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

以异步方式创建媒体项。 如果创建了多个项，则操作可以按任何顺序完成，不一定与方法调用的顺序相同。 如果同时有挂起的请求，则可以使用 dwUserData 成员来标识这些项。

要求

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

另请参阅

IMFPMediaPlayerCallback

媒体基础结构

使用 MFPlay 进行音频/视频播放