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

Define a URL de um recurso de mídia.

Sintaxe

HRESULT SetSource(
  [in] BSTR pUrl
);

Parâmetros

[in] pUrl

A URL do recurso de mídia.

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

Esse método corresponde à configuração do atributo src da interface HTMLMediaElement em HTML5.

A URL especificada por esse método tem precedência sobre os recursos de mídia especificados no método IMFMediaEngine::SetSourceElements . Para carregar a URL, chame IMFMediaEngine::Load.

Esse método carrega de forma assíncrona a URL. Quando a operação é 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 a URL, o Mecanismo de Mídia enviará um evento de MF_MEDIA_ENGINE_EVENT_ERROR .

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

Requisitos

   
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