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
有关媒体引擎中的事件处理的详细信息,请参阅 IMFMediaEngineNotify。
如果应用程序还调用 IMFMediaEngine::SetSource,则传递给 SetSource 的 URL 优先于提供给 SetSourceElements 的列表。
要求
最低受支持的客户端 | Windows 8 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows Server 2012 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | mfmediaengine.h |