IMFMediaEngine::SetSourceElements 方法 (mfmediaengine.h)

设置媒体源的列表。

语法

HRESULT SetSourceElements(
  [in] IMFMediaEngineSrcElements *pSrcElements
);

parameters

[in] pSrcElements

指向 IMFMediaEngineSrcElements 接口的 指针。 调用方必须实现此接口。

返回值

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

此方法对应于将 元素列表添加到 HTML5 中的媒体元素。

媒体引擎会尝试加载 pSrcElements 列表中的每一项,直到找到成功加载的项。 调用此方法后,应用程序可以随时使用 IMFMediaEngineSrcElements 接口更新列表。 若要重新加载列表,请调用 IMFMediaEngine::Load

此方法以异步方式完成。 操作开始时,媒体引擎会发送 MF_MEDIA_ENGINE_EVENT_LOADSTART 事件。 如果在 加载 操作期间未发生错误,则会生成其他几个事件,包括以下内容。

  • MF_MEDIA_ENGINE_EVENT_LOADEDMETADATA
  • MF_MEDIA_ENGINE_EVENT_LOADEDDATA
  • MF_MEDIA_ENGINE_EVENT_CANPLAY
  • MF_MEDIA_ENGINE_EVENT_CANPLAYTHROUGH
如果媒体引擎无法加载 URL,则会发送 MF_MEDIA_ENGINE_EVENT_ERROR 事件。

有关媒体引擎中的事件处理的详细信息,请参阅 IMFMediaEngineNotify

如果应用程序还调用 IMFMediaEngine::SetSource,则传递给 SetSource 的 URL 优先于提供给 SetSourceElements 的列表

要求

   
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows
标头 mfmediaengine.h

另请参阅

IMFMediaEngine