Método IVMRFilterConfig::SetImageCompositor (strmif.h)

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El SetImageCompositor método instala un compositor de imágenes proporcionado por la aplicación.

Sintaxis

HRESULT SetImageCompositor(
  [in] IVMRImageCompositor *lpVMRImgCompositor
);

Parámetros

[in] lpVMRImgCompositor

Puntero a la interfaz IVMRImageCompositor del compositor de imágenes.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, devuelve un código de error.

Código devuelto	Descripción
VFW_E_WRONG_STATE	El mezclador no está cargado actualmente.

Comentarios

Use este método para reemplazar el compositor predeterminado de VMR por un compositor personalizado proporcionado por la aplicación. El compositor de imágenes es un subcomponente del mezclador.

El compositor se carga automáticamente cuando el VMR está en modo sin ventanas o con ventanas. Cuando VMR está en modo sin representación, el compositor debe cargarse llamando a IVMRFilterConfig::SetNumberOfStreams. VMR administra todas las referencias contando con la interfaz IVMRImageCompositor .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP1 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	strmif.h (incluya Dshow.h)
Library	Strmiids.lib

Consulte también

Códigos de error y éxito

IVMRFilterConfig (interfaz)

Uso del representador de mezcla de vídeos