Compartir a través de

Función GetMonitorCapabilities (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.

Recupera las funcionalidades de configuración de un monitor. Llame a esta función para averiguar qué funciones de configuración de supervisión de alto nivel son compatibles con el monitor.

Sintaxis

_BOOL GetMonitorCapabilities(
  [in]  HANDLE  hMonitor,
  [out] LPDWORD pdwMonitorCapabilities,
  [out] LPDWORD pdwSupportedColorTemperatures
);

Parámetros

[in] hMonitor

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

[out] pdwMonitorCapabilities

Recibe un OR bit a bit de marcas de funcionalidades. Vea la sección Comentarios.

[out] pdwSupportedColorTemperatures

Recibe un OR bit a bit de marcas de temperatura de color. Vea la sección Comentarios.

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.

Se produce un error en la función si el monitor no admite DDC/CI.

Comentarios

Las marcas de funcionalidades devueltas en pdwMonitorCapabilities especifican qué funciones de configuración de supervisión de alto nivel son compatibles con el monitor. También especifican cómo se comportan determinadas funciones. Se definen las siguientes marcas de funcionalidad.

Valor Descripción
MC_CAPS_BRIGHTNESS El monitor admite las funciones GetMonitorBrightness y SetMonitorBrightness .
MC_CAPS_COLOR_TEMPERATURE El monitor admite las funciones GetMonitorColorTemperature y SetMonitorColorTemperature .
MC_CAPS_CONTRAST El monitor admite las funciones GetMonitorContrast y SetMonitorContrast .
MC_CAPS_DEGAUSS El monitor admite la función DegaussMonitor .
MC_CAPS_DISPLAY_AREA_POSITION El monitor admite las funciones GetMonitorDisplayAreaPosition y SetMonitorDisplayAreaPosition .
MC_CAPS_DISPLAY_AREA_SIZE El monitor admite las funciones GetMonitorDisplayAreaSize y SetMonitorDisplayAreaSize .
MC_CAPS_MONITOR_TECHNOLOGY_TYPE El monitor admite la función GetMonitorTechnologyType .
MC_CAPS_NONE El monitor no admite ninguna configuración de supervisión.
MC_CAPS_RED_GREEN_BLUE_DRIVE El monitor admite las funciones GetMonitorRedGreenOrBlueDrive y SetMonitorRedGreenOrBlueDrive .
MC_CAPS_RED_GREEN_BLUE_GAIN El monitor admite las funciones GetMonitorRedGreenOrBlueGain y SetMonitorRedGreenOrBlueGain .
MC_CAPS_RESTORE_FACTORY_COLOR_DEFAULTS El monitor admite la función RestoreMonitorFactoryColorDefaults .
MC_CAPS_RESTORE_FACTORY_DEFAULTS El monitor admite la función RestoreMonitorFactoryDefaults .
MC_RESTORE_FACTORY_DEFAULTS_ENABLES_MONITOR_SETTINGS Si esta marca está presente, al llamar a la función RestoreMonitorFactoryDefaults se habilitan todas las opciones de supervisión usadas por las funciones de configuración de supervisión de alto nivel. Para obtener más información, vea la sección Comentarios de RestoreMonitorFactoryDefaults.
 

Las marcas de temperatura de color devueltas en pdwSupportedColorTemperatures especifican qué temperaturas de color admite el monitor. Se definen las marcas de temperatura de color siguientes.

Valor Descripción
MC_SUPPORTED_COLOR_TEMPERATURE_NONE No se admiten temperaturas de color.
MC_SUPPORTED_COLOR_TEMPERATURE_4000K El monitor admite 4000 kelvins (K) temperatura de color.
MC_SUPPORTED_COLOR_TEMPERATURE_5000K El monitor admite una temperatura de color de 5.000 K.
MC_SUPPORTED_COLOR_TEMPERATURE_6500K El monitor admite una temperatura de color de 6.500 K.
MC_SUPPORTED_COLOR_TEMPERATURE_7500K El monitor admite una temperatura de color de 7.500 K.
MC_SUPPORTED_COLOR_TEMPERATURE_8200K El monitor admite una temperatura de color de 8 200 K.
MC_SUPPORTED_COLOR_TEMPERATURE_9300K El monitor admite una temperatura de color de 9.300 K.
MC_SUPPORTED_COLOR_TEMPERATURE_10000K El monitor admite una temperatura de color de 10 000 K.
MC_SUPPORTED_COLOR_TEMPERATURE_11500K El monitor admite una temperatura de color de 11 500 K.

Requisitos

Requisito Value
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