IMFMediaEngine::Load 方法 (mfmediaengine.h)
加载当前媒体源。
语法
HRESULT Load();
返回值
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
此方法main目的是在更新列表后重新加载源元素列表。 有关详细信息,请参阅 SetSourceElements。 否则,通常不需要调用此方法。 若要加载新的媒体源,请调用 IMFMediaEngine::SetSource 或 IMFMediaEngine::SetSourceElements。
Load 方法显式调用媒体引擎的媒体资源加载算法。 在调用此方法之前,必须通过调用 IMFMediaEngine::SetSource 或 IMFMediaEngine::SetSourceElements 来设置媒体资源。
此方法异步完成。 加载操作启动时,媒体引擎会发送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。
此方法对应于 HTML5 中 HTMLMediaElement 接口的 load 方法。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows Server 2012 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | mfmediaengine.h |