IMFMediaEngine::Load メソッド (mfmediaengine.h)

現在のメディア ソースを読み込みます。

構文

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 インターフェイスの load メソッドに対応します。

要件

こちらもご覧ください

IMFMediaEngine