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 |
---|---|
|
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 |