Метод IMFMediaEngine::SetSource (mfmediaengine.h)

Задает URL-адрес ресурса мультимедиа.

Синтаксис

HRESULT SetSource(
  [in] BSTR pUrl
);

Параметры

[in] pUrl

URL-адрес ресурса мультимедиа.

Возвращаемое значение

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод соответствует настройке атрибута src интерфейса HTMLMediaElement в HTML5.

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
Header mfmediaengine.h

См. также раздел

IMFMediaEngine