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 メソッドに対応します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | mfmediaengine.h |