Método IMFMediaEngine::Load (mfmediaengine.h)

Carga el origen multimedia actual.

Sintaxis

HRESULT Load();

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El propósito principal de este método es volver a cargar una lista de elementos de origen después de actualizar la lista. Para obtener más información, vea SetSourceElements. De lo contrario, normalmente no es necesario llamar a este método. Para cargar un nuevo origen multimedia, llame a IMFMediaEngine::SetSource o IMFMediaEngine::SetSourceElements.

El método Load invoca explícitamente el algoritmo de carga de recursos multimedia del motor multimedia. Antes de llamar a este método, debe establecer el recurso multimedia llamando a IMFMediaEngine::SetSource o IMFMediaEngine::SetSourceElements.

Este método se completa de forma asincrónica. Cuando se inicia la operación de carga , el motor multimedia envía un evento MF_MEDIA_ENGINE_EVENT_LOADSTART . Si no se produce ningún error durante la operación de carga , se generan otros eventos, incluidos los siguientes.

  • MF_MEDIA_ENGINE_EVENT_LOADEDMETADATA
  • MF_MEDIA_ENGINE_EVENT_LOADEDDATA
  • MF_MEDIA_ENGINE_EVENT_CANPLAY
  • MF_MEDIA_ENGINE_EVENT_CANPLAYTHROUGH
Si el motor multimedia no puede cargar el archivo, el motor multimedia envía un evento de MF_MEDIA_ENGINE_EVENT_ERROR .

Para obtener más información sobre el control de eventos en el motor multimedia, vea IMFMediaEngineNotify.

Este método corresponde al método de carga de la interfaz HTMLMediaElement en HTML5.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado mfmediaengine.h

Consulte también

IMFMediaEngine