共用方式為


IMFMediaEngine::Load 方法 (mfmediaengine.h)

載入目前的媒體來源。

Syntax

HRESULT Load();

傳回值

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

此方法的主要目的是在更新清單之後重載來源元素清單。 如需詳細資訊,請參閱 SetSourceElements。 否則,通常不需要呼叫這個方法。 若要載入新的媒體來源,請呼叫 IMFMediaEngine::SetSourceIMFMediaEngine::SetSourceElements

Load 方法會明確叫用媒體引擎的媒體資源載入演算法。 呼叫此方法之前,您必須呼叫 IMFMediaEngine::SetSourceIMFMediaEngine::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
如果媒體引擎無法載入檔案,媒體引擎會傳送 MF_MEDIA_ENGINE_EVENT_ERROR 事件。

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

這個方法會對應至 HTML5 中 HTMLMediaElement 介面的載入方法。

規格需求

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

另請參閱

IMFMediaEngine