共用方式為


IMFMediaEngine::SetSourceElements 方法 (mfmediaengine.h)

設定媒體來源的清單。

語法

HRESULT SetSourceElements(
  [in] IMFMediaEngineSrcElements *pSrcElements
);

參數

[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
如果媒體引擎無法載入 URL,它會傳送 MF_MEDIA_ENGINE_EVENT_ERROR 事件。

如需媒體引擎中事件處理的詳細資訊,請參閱 IMFMediaEngineNotify

如果應用程式也呼叫 IMFMediaEngine::SetSource,傳遞至 SetSource 的 URL 會優先于指定給 SetSourceElements的清單。

需求

   
最低支援的用戶端 Windows 8 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2012 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 mfmediaengine.h

另請參閱

IMFMediaEngine