IMFMediaEngine::SetSource 方法 (mfmediaengine.h)

設定媒體資源的 URL。

語法

HRESULT SetSource(
  [in] BSTR pUrl
);

參數

[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