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
メディア エンジンでのイベント処理の詳細については、「 IMFMediaEngineNotify」を参照してください。
要件
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | mfmediaengine.h |