IMFMediaEngine::Load 方法 (mfmediaengine.h)
載入目前的媒體來源。
Syntax
HRESULT Load();
傳回值
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
此方法的主要目的是在更新清單之後重載來源元素清單。 如需詳細資訊,請參閱 SetSourceElements。 否則,通常不需要呼叫這個方法。 若要載入新的媒體來源,請呼叫 IMFMediaEngine::SetSource 或 IMFMediaEngine::SetSourceElements。
Load 方法會明確叫用媒體引擎的媒體資源載入演算法。 呼叫此方法之前,您必須呼叫 IMFMediaEngine::SetSource 或 IMFMediaEngine::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
如需媒體引擎中事件處理的詳細資訊,請參閱 IMFMediaEngineNotify。
這個方法會對應至 HTML5 中 HTMLMediaElement 介面的載入方法。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2012 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | mfmediaengine.h |