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

メディア リソースの URL を設定します。

構文

HRESULT SetSource(
  [in] BSTR pUrl
);

パラメーター

[in] pUrl

メディア リソースの URL。

戻り値

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

解説

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

このメソッドで指定された URL は、 IMFMediaEngine::SetSourceElements メソッドで指定されたメディア リソースよりも優先されます。 URL を読み込むには、 IMFMediaEngine::Load を呼び出します。

このメソッドは、URL を非同期的に読み込みます。 操作が開始されると、メディア エンジンは 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」を参照してください。

要件

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

関連項目

IMFMediaEngine