IMFPMediaPlayer：：SetMediaItem 方法 (mfplay.h)

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

将媒体项排队播放。

语法

HRESULT SetMediaItem(
  [in] IMFPMediaItem *pIMFPMediaItem
);

[in] pIMFPMediaItem

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

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

返回代码	说明
S_OK	方法成功。
E_INVALIDARG	无效的参数。
MF_E_DRM_UNSUPPORTED	媒体项包含受保护的内容。 MFPlay 当前不支持受保护的内容。
MF_E_NO_AUDIO_PLAYBACK_DEVICE	找不到音频播放设备。如果媒体源包含音频，但系统上没有可用的音频播放设备，则会发生此错误。
MF_E_SHUTDOWN	调用了对象的 Shutdown 方法。

此方法异步完成。操作完成后，将调用应用程序的 IMFPMediaPlayerCallback：：OnMediaPlayerEvent 回调方法。事件类型为 MFP_EVENT_TYPE_MEDIAITEM_SET。

若要创建媒体项，请调用 IMFPMediaPlayer：：CreateMediaItemFromObject 或 IMFPMediaPlayer：：CreateMediaItemFromURL。媒体项必须与创建该项目的同一 MFPlay 播放器对象一起使用。如果媒体项是由播放器对象的其他实例创建的， 则 SetMediaItem 返回 E_INVALIDARG。