Función SetMonitorColorTemperature (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 la temperatura de color de un monitor.

Sintaxis

_BOOL SetMonitorColorTemperature(
  [in] HANDLE               hMonitor,
  [in] MC_COLOR_TEMPERATURE ctCurrentColorTemperature
);

Parámetros

[in] hMonitor

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

[in] ctCurrentColorTemperature

Temperatura del color, especificada como miembro de la enumeración MC_COLOR_TEMPERATURE .

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

Si se admite esta función, la función GetMonitorCapabilities devuelve la marca MC_CAPS_COLOR_TEMPERATURE. La función GetMonitorCapabilities también devuelve el intervalo de temperaturas de color que admite el monitor. El parámetro ctCurrentColorTemperature debe corresponder a uno de estos valores.

Cambiar la temperatura del color cambia el punto blanco del monitor. También puede cambiar la unidad actual y obtener la configuración. Para obtener la nueva unidad y obtener la configuración, llame a GetMonitorRedGreenOrBlueDrive y GetMonitorRedGreenOrBlueGain, respectivamente.

Esta función tarda entre 50 y 90 milisegundos en devolverse.

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