IMFMediaEngine::Load 方法 (mfmediaengine.h)

加载当前媒体源。

语法

HRESULT Load();

返回值

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

注解

此方法main目的是在更新列表后重新加载源元素列表。 有关详细信息,请参阅 SetSourceElements。 否则,通常不需要调用此方法。 若要加载新的媒体源,请调用 IMFMediaEngine::SetSourceIMFMediaEngine::SetSourceElements

Load 方法显式调用媒体引擎的媒体资源加载算法。 在调用此方法之前,必须通过调用 IMFMediaEngine::SetSourceIMFMediaEngine::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
如果媒体引擎无法加载文件,媒体引擎会发送 MF_MEDIA_ENGINE_EVENT_ERROR 事件。

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

此方法对应于 HTML5 中 HTMLMediaElement 接口的 load 方法。

要求

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

另请参阅

IMFMediaEngine