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