Compartir a través de


Función MFCreateVideoRendererActivate (mfidl.h)

Crea un objeto de activación para el receptor de medios del representador de vídeo mejorado (EVR).

Sintaxis

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

Parámetros

[in] hwndVideo

Controle a la ventana donde se mostrará el vídeo.

[out] ppActivate

Recibe un puntero a la interfaz IMFActivate . Use esta interfaz para crear el EVR. El autor de la llamada debe liberar la interfaz .

Valor devuelto

La función devuelve un HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
El método se ha llevado a cabo de forma correcta.

Comentarios

Para crear el EVR, llame a IMFActivate::ActivateObject en el puntero IMFActivate recuperado. (Si usa la sesión multimedia, la sesión multimedia llama automáticamente a ActivateObject cuando pone en cola la topología).

Para configurar el EVR, establezca cualquiera de los siguientes atributos en el objeto IMFActivate antes de llamar a ActivateObject.

Atributo Descripción
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_ACTIVATE Objeto de activación para un mezclador personalizado.
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_CLSID CLSID para un mezclador personalizado.
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_FLAGS Marcas para crear un mezclador personalizado.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_ACTIVATE Objeto de activación para un moderador personalizado.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_CLSID CLSID para un moderador personalizado.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_FLAGS Marcas para crear un moderador personalizado.
 

Cuando se llama a IMFActivate::ActivateObject , los objetos de activación establecen la ventana de vídeo en el EVR llamando a IMFVideoDisplayControl::SetVideoPosition. Pasar NULL para el parámetro hwndVideo no es un error, pero no se representará ningún vídeo a menos que el EVR tenga una ventana de vídeo válida.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mfidl.h
Library Mf.lib
Archivo DLL Mf.dll

Consulte también

Objetos de activación

Representador de vídeo mejorado

Funciones de Media Foundation