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