Função MFCreateVideoRendererActivate (mfidl.h)

Cria um objeto de ativação para o coletor de mídia EVR (renderizador de vídeo) aprimorado.

Sintaxe

HRESULT MFCreateVideoRendererActivate(
  [in]  HWND        hwndVideo,
  [out] IMFActivate **ppActivate
);

Parâmetros

[in] hwndVideo

Manipule para a janela em que o vídeo será exibido.

[out] ppActivate

Recebe um ponteiro para a interface IMFActivate . Use essa interface para criar o EVR. O chamador deve liberar a interface.

Retornar valor

A função retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
O método foi bem-sucedido.

Comentários

Para criar o EVR, chame IMFActivate::ActivateObject no ponteiro IMFActivate recuperado. (Se você estiver usando a Sessão de Mídia, a Sessão de Mídia chamará ActivateObject automaticamente quando você enfileirar a topologia.)

Para configurar o EVR, defina qualquer um dos seguintes atributos no objeto IMFActivate antes de chamar ActivateObject.

Atributo Descrição
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_ACTIVATE Objeto de ativação para um mixer personalizado.
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_CLSID CLSID para um mixer personalizado.
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_FLAGS Sinalizadores para criar um mixer personalizado.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_ACTIVATE Objeto de ativação para um apresentador personalizado.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_CLSID CLSID para um apresentador personalizado.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_FLAGS Sinalizadores para criar um apresentador personalizado.
 

Quando IMFActivate::ActivateObject é chamado, os objetos de ativação definem a janela de vídeo no EVR chamando IMFVideoDisplayControl::SetVideoPosition. Passar NULL para o parâmetro hwndVideo não é um erro, mas nenhum vídeo será renderizado, a menos que o EVR tenha uma janela de vídeo válida.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mfidl.h
Biblioteca Mf.lib
DLL Mf.dll

Confira também

Objetos de ativação

Renderizador de Vídeo Aprimorado

Funções do Media Foundation