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
如果媒體引擎無法載入檔案，媒體引擎會傳送 MF_MEDIA_ENGINE_EVENT_ERROR 事件。

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

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

規格需求

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

另請參閱

IMFMediaEngine