Share via

IMFPMediaPlayer：：GetMediaItem 方法 (mfplay.h)

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

获取指向当前媒体项的指针。

语法

HRESULT GetMediaItem(
  [out] IMFPMediaItem **ppIMFPMediaItem
);

parameters

[out] ppIMFPMediaItem

接收指向媒体项的 IMFPMediaItem 接口的指针。 调用方必须释放接口。

返回值

该方法返回 HRESULT。 可能的值包括（但并不限于）下表中的项。

返回代码 说明
S_OK
 方法成功。
E_FAIL
 没有当前媒体项。
MF_E_NOT_FOUND
 没有当前媒体项。
MF_E_SHUTDOWN
 调用了对象的 Shutdown 方法。

注解

IMFPMediaPlayer：：SetMediaItem 方法是异步的。 因此，当 SetMediaItem 挂起时， GetMediaItem 不会返回刚刚设置的媒体项。 相反，应用程序应实现 IMFPMediaPlayerCallback 接口并处理 MFP_EVENT_TYPE_MEDIAITEM_SET 事件。 有关详细信息，请参阅 从播放器接收事件。

上述注释也适用于在 MFPCreateMediaPlayer 函数中设置媒体项。

要求

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

另请参阅

IMFPMediaPlayer

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