IMFMediaEngine::SetSource 方法 (mfmediaengine.h)

设置媒体资源的 URL。

语法

HRESULT SetSource(
  [in] BSTR pUrl
);

parameters

[in] pUrl

媒体资源的 URL。

返回值

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

注解

此方法对应于在 HTML5 中设置 HTMLMediaElement 接口的 src 属性。

此方法指定的 URL 优先于 IMFMediaEngine::SetSourceElements 方法中指定的媒体资源。 若要加载 URL,请调用 IMFMediaEngine::Load

此方法异步加载 URL。 当操作启动时,媒体引擎会发送 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

要求

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

另请参阅

IMFMediaEngine