Método IVMRMonitorConfig::SetDefaultMonitor (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 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 |
|---|---|
|
No se pudo establecer el monitor especificado como predeterminado. |
|
Argumento no válido. El monitor especificado no existe o el parámetro pGUID no tiene el formato correcto. |
|
Argumento de puntero NULL. |
|
Correcto. |
|
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 |