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

メディア ソースの一覧を設定します。

構文

HRESULT SetSourceElements(
  [in] IMFMediaEngineSrcElements *pSrcElements
);

パラメーター

[in] pSrcElements

IMFMediaEngineSrcElements インターフェイスへのポインター。 呼び出し元は、このインターフェイスを実装する必要があります。

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

このメソッドは、HTML5 のメディア要素に ソース 要素のリストを追加する場合に対応します。

メディア エンジンは、正常に読み込まれた項目が見つかるまで、 pSrcElements リスト内の各項目の読み込みを試みます。 このメソッドが呼び出されると、アプリケーションは IMFMediaEngineSrcElements インターフェイスを使用して、いつでもリストを更新できます。 リストを再読み込みするには、 IMFMediaEngine::Load を呼び出します。

このメソッドは非同期的に完了します。 操作が開始されると、メディア エンジンは 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

メディア エンジンが URL を読み込めない場合は、 MF_MEDIA_ENGINE_EVENT_ERROR イベントが送信されます。

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

アプリケーションが IMFMediaEngine::SetSource も呼び出す場合、SetSource に渡される URL は、SetSourceElements に指定されたリストよりも優先されます。

要件

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

関連項目

IMFMediaEngine