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