Share via

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
メディア エンジンがファイルを読み込めない場合、メディア エンジンは MF_MEDIA_ENGINE_EVENT_ERROR イベントを送信します。

メディア エンジンでのイベント処理の詳細については、「 IMFMediaEngineNotify」を参照してください。

このメソッドは、HTML5 の HTMLMediaElement インターフェイスの load メソッドに対応します。

要件

要件 値
サポートされている最小のクライアント Windows 8 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー mfmediaengine.h

こちらもご覧ください

IMFMediaEngine