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
如需媒體引擎中事件處理的詳細資訊,請參閱 IMFMediaEngineNotify。
如果應用程式也呼叫 IMFMediaEngine::SetSource,傳遞至 SetSource 的 URL 會優先于指定給 SetSourceElements的清單。
需求
最低支援的用戶端 | Windows 8 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2012 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | mfmediaengine.h |