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

Carrega a fonte de mídia atual.

Sintaxe

HRESULT Load();

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

A finalidade main desse método é recarregar uma lista de elementos de origem após atualizar a lista. Para obter mais informações, consulte SetSourceElements. Caso contrário, chamar esse método geralmente não é necessário. Para carregar uma nova fonte de mídia, chame IMFMediaEngine::SetSource ou IMFMediaEngine::SetSourceElements.

O método Load invoca explicitamente o algoritmo de carregamento de recursos de mídia do Mecanismo de Mídia. Antes de chamar esse método, você deve definir o recurso de mídia chamando IMFMediaEngine::SetSource ou IMFMediaEngine::SetSourceElements.

Esse método é concluído de forma assíncrona. Quando a operação Carregar é iniciada, o Mecanismo de Mídia envia um evento MF_MEDIA_ENGINE_EVENT_LOADSTART . Se nenhum erro ocorrer durante a operação Carregar , vários outros eventos serão gerados, incluindo o seguinte.

• MF_MEDIA_ENGINE_EVENT_LOADEDMETADATA
• MF_MEDIA_ENGINE_EVENT_LOADEDDATA
• MF_MEDIA_ENGINE_EVENT_CANPLAY
• MF_MEDIA_ENGINE_EVENT_CANPLAYTHROUGH

Se o Mecanismo de Mídia não puder carregar o arquivo, o Mecanismo de Mídia enviará um evento MF_MEDIA_ENGINE_EVENT_ERROR .

Para obter mais informações sobre o tratamento de eventos no Mecanismo de Mídia, consulte IMFMediaEngineNotify.

Esse método corresponde ao método load da interface HTMLMediaElement em HTML5.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	mfmediaengine.h

Confira também

IMFMediaEngine