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

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