Compartir a través de

Método IVMRMonitorConfig::SetDefaultMonitor (strmif.h)

  • Artículo

[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 SetDefaultMonitor método especifica el monitor predeterminado que todas las instancias futuras de VMR deben usar para la reproducción de vídeo.

Sintaxis

HRESULT SetDefaultMonitor(
  [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_FAIL
 No se pudo establecer el monitor especificado como predeterminado.
E_INVALIDARG
 Argumento no válido. El monitor especificado no existe o el parámetro pGUID no tiene el formato correcto.
E_POINTER
 Argumento de puntero NULL.
S_OK
 Correcto.
VFW_E_WRONG_STATE
 No se ha cargado el asignador-moderador.

Observaciones

Use este método en un sistema de varios monitores para especificar en vmR el dispositivo DirectDraw predeterminado que se usará al conectarse a un filtro ascendente. El dispositivo DirectDraw predeterminado se puede invalidar para una conexión determinada mediante el método SetMonitor .

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

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

Uso del representador de mezcla de vídeos