Función SetMonitorRedGreenOrBlueDrive (highlevelmonitorconfigurationapi.h)

Advertencia

Las funciones de configuración del monitor físico funcionan con el estándar VESA Monitor Control Command Set (MCCS) a través de una interfaz I²C. Muchos monitores no implementan completamente ese estándar; por lo que el uso de estos comandos podría dar lugar a un comportamiento de supervisión indefinido. No se recomienda usar estas funciones para monitores arbitrarios sin validar físicamente que funcionan según lo previsto.

Establece el valor de unidad rojo, verde o azul de un monitor.

Sintaxis

_BOOL SetMonitorRedGreenOrBlueDrive(
  [in] HANDLE        hMonitor,
  [in] MC_DRIVE_TYPE dtDriveType,
  [in] DWORD         dwNewDrive
);

Parámetros

[in] hMonitor

Identificador de un monitor físico. Para obtener el identificador del monitor, llame a GetPhysicalMonitorsFromHMONITOR o GetPhysicalMonitorsFromIDirect3DDevice9.

[in] dtDriveType

Miembro de la enumeración MC_DRIVE_TYPE , especificando si se va a establecer el valor de unidad rojo, verde o azul.

[in] dwNewDrive

Valor de unidad rojo, verde o azul. Para obtener los valores de unidad mínima y máxima del monitor, llame a GetMonitorRedGreenOrBlueDrive.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es TRUE. Si se produce un error en la función, el valor devuelto es FALSE. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La configuración de la unidad se usa generalmente para ajustar el punto blanco del monitor. La unidad y el nivel negro son nombres diferentes para la misma configuración de monitor.

Si se admite esta función, la función GetMonitorCapabilities devuelve la marca MC_CAPS_RED_GREEN_BLUE_DRIVE.

Esta función tarda aproximadamente 50 milisegundos en devolverse.

Cambiar la configuración de la unidad puede cambiar la temperatura del color. Para obtener la nueva temperatura de color, llame a GetMonitorColorTemperature.

La configuración de la unidad es la configuración de supervisión continua. Para obtener más información, vea Uso de las funciones de configuración de High-Level Monitor.

Requisitos

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	highlevelmonitorconfigurationapi.h
Library	Dxva2.lib
Archivo DLL	Dxva2.dll

Consulte también

Supervisar funciones de configuración