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

  • Статья

Загружает текущий источник мультимедиа.

Синтаксис

HRESULT Load();

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

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

Комментарии

Main целью этого метода является перезагрузка списка исходных элементов после обновления списка. Дополнительные сведения см. в разделе SetSourceElements. В противном случае вызов этого метода обычно не требуется. Чтобы загрузить новый источник мультимедиа, позвоните по телефону IMFMediaEngine::SetSource или IMFMediaEngine::SetSourceElements.

Метод Load явно вызывает алгоритм загрузки медиаресурсов обработчика мультимедиа. Перед вызовом этого метода необходимо задать ресурс мультимедиа, вызвав IMFMediaEngine::SetSource или IMFMediaEngine::SetSourceElements.

Этот метод выполняется асинхронно. При запуске операции 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
Если обработчику мультимедиа не удается загрузить файл, обработчик мультимедиа отправляет событие MF_MEDIA_ENGINE_EVENT_ERROR .

Дополнительные сведения об обработке событий в обработчике мультимедиа см. в разделе IMFMediaEngineNotify.

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

Требования

Требование Значение
Минимальная версия клиента Windows 8 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header mfmediaengine.h

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

IMFMediaEngine