Compartir a través de

Función SetMonitorRedGreenOrBlueGain (highlevelmonitorconfigurationapi.h)

  • Artículo

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 I2C. 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 ganancia rojo, verde o azul de un monitor.

Sintaxis

_BOOL SetMonitorRedGreenOrBlueGain(
  [in] HANDLE       hMonitor,
  [in] MC_GAIN_TYPE gtGainType,
  [in] DWORD        dwNewGain
);

Parámetros

[in] hMonitor

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

[in] gtGainType

Miembro de la enumeración MC_GAIN_TYPE , especificando si se va a establecer la ganancia roja, verde o azul.

[in] dwNewGain

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

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 ganancia se usa generalmente para ajustar el punto blanco del monitor.

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

Esta función tarda aproximadamente 50 milisegundos en devolverse.

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

La configuración de ganancia 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