Método IVMRMonitorConfig::SetMonitor (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.

En un sistema de varios monitores, el SetMonitor método especifica el monitor que esta instancia de VMR debe usar para la reproducción de vídeo.

Sintaxis

HRESULT SetMonitor(
  [in] const VMRGUID *pGUID
);

Parámetros

[in] pGUID

Puntero a una estructura VMRGUID que identifica el monitor.

Valor devuelto

Devuelve un valor HRESULT . Estos son algunos de los valores posibles.

Código devuelto	Descripción
E_INVALIDARG	Argumento no válido.
E_POINTER	Argumento de puntero NULL.
S_OK	Correcto.
VFW_E_WRONG_STATE	No se ha cargado el asignador-moderador.

Comentarios

Use este método en un sistema de varios monitores para especificar en el VMR que se debe usar el controlador directDraw al conectarse a un filtro de descodificador ascendente.

El miembro pGUID de la estructura VMRGUID debe ser NULL, que indica el dispositivo DirectDraw predeterminado o igual a la dirección del miembro GUID de la estructura VMRGUID . De lo contrario, el método devuelve E_INVALIDARG.

Si el GUID especificado no corresponde a ningún monitor, el método devuelve E_INVALIDARG.

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

IVMRMonitorConfig (interfaz)

IVMRMonitorConfig::GetMonitor

Uso del representador de mezcla de vídeos