Funzione GetMonitorCapabilities (highlevelmonitorconfigurationapi.h)

Articolo
02/26/2024

Avviso

Le funzioni di configurazione del monitoraggio fisico funzionano usando lo standard MCCS (VESA Monitor Control Set) su un'interfaccia I²C. Molti monitor non implementano completamente tale standard; pertanto l'uso di questi comandi potrebbe comportare un comportamento di monitoraggio non definito. Non è consigliabile usare queste funzioni per monitoraggi arbitrari senza convalidare fisicamente che funzionino come previsto.

Recupera le funzionalità di configurazione di un monitoraggio. Chiamare questa funzione per scoprire quali funzioni di configurazione di monitoraggio di alto livello sono supportate dal monitoraggio.

Sintassi

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

Parametri

[in] hMonitor

Gestire in un monitor fisico. Per ottenere l'handle di monitoraggio, chiamare GetPhysicalMonitorsFromHMONITOR o GetPhysicalMonitorsFromIDirect3DDevice9.

[out] pdwMonitorCapabilities

Riceve un OR bit per bit dei flag di funzionalità. Vedere la sezione Osservazioni.

[out] pdwSupportedColorTemperatures

Riceve un OR bit per bit dei flag di temperatura colore. Vedere la sezione Osservazioni.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE. Se la funzione ha esito negativo, il valore restituito è FALSE. Per informazioni dettagliate sull'errore, chiamare GetLastError.

La funzione ha esito negativo se il monitoraggio non supporta DDC/CI.

Commenti

I flag di funzionalità restituiti in pdwMonitorCapabilities specificano quali funzioni di configurazione di monitoraggio di alto livello sono supportate dal monitoraggio. Specificano anche il comportamento di determinate funzioni. Vengono definiti i flag di funzionalità seguenti.

Valore	Descrizione
MC_CAPS_BRIGHTNESS	Il monitoraggio supporta le funzioni GetMonitorBrightness e SetMonitorBrightness .
MC_CAPS_COLOR_TEMPERATURE	Il monitoraggio supporta le funzioni GetMonitorColorTemperature e SetMonitorColorTemperature .
MC_CAPS_CONTRAST	Il monitoraggio supporta le funzioni GetMonitorContrast e SetMonitorContrast .
MC_CAPS_DEGAUSS	Il monitoraggio supporta la funzione DeintunessMonitor .
MC_CAPS_DISPLAY_AREA_POSITION	Il monitoraggio supporta le funzioni GetMonitorDisplayAreaPosition e SetMonitorDisplayAreaPosition .
MC_CAPS_DISPLAY_AREA_SIZE	Il monitoraggio supporta le funzioni GetMonitorDisplayAreaSize e SetMonitorDisplayAreaSize .
MC_CAPS_MONITOR_TECHNOLOGY_TYPE	Il monitoraggio supporta la funzione GetMonitorTechnologyType .
MC_CAPS_NONE	Il monitoraggio non supporta alcuna impostazione di monitoraggio.
MC_CAPS_RED_GREEN_BLUE_DRIVE	Il monitoraggio supporta le funzioni GetMonitorRedGreenOrBlueDrive e SetMonitorRedGreenOrBlueDrive .
MC_CAPS_RED_GREEN_BLUE_GAIN	Il monitoraggio supporta le funzioni GetMonitorRedGreenOrBlueGain e SetMonitorRedGreenOrBlueGain .
MC_CAPS_RESTORE_FACTORY_COLOR_DEFAULTS	Il monitoraggio supporta la funzione RestoreMonitorFactoryColorDefaults .
MC_CAPS_RESTORE_FACTORY_DEFAULTS	Il monitoraggio supporta la funzione RestoreMonitorFactoryDefaults .
MC_RESTORE_FACTORY_DEFAULTS_ENABLES_MONITOR_SETTINGS	Se questo flag è presente, la chiamata alla funzione RestoreMonitorFactoryDefaults abilita tutte le impostazioni di monitoraggio usate dalle funzioni di configurazione di monitoraggio di alto livello. Per altre informazioni, vedere la sezione Osservazioni in RestoreMonitorFactoryDefaults.

I flag di temperatura colore restituiti in pdwSupportedColorTemperatures specificano le temperature di colore supportate dal monitor. Vengono definiti i flag di temperatura colore seguenti.

Valore	Descrizione
MC_SUPPORTED_COLOR_TEMPERATURE_NONE	Non sono supportate temperature di colore.
MC_SUPPORTED_COLOR_TEMPERATURE_4000K	Il monitor supporta 4.000 kelvins (K) temperatura colore.
MC_SUPPORTED_COLOR_TEMPERATURE_5000K	Il monitor supporta una temperatura di colore di 5.000 K.
MC_SUPPORTED_COLOR_TEMPERATURE_6500K	Il monitor supporta una temperatura di colore di 6.500 K.
MC_SUPPORTED_COLOR_TEMPERATURE_7500K	Il monitor supporta una temperatura di colore di 7.500 K.
MC_SUPPORTED_COLOR_TEMPERATURE_8200K	Il monitor supporta una temperatura di colore di 8.200 K.
MC_SUPPORTED_COLOR_TEMPERATURE_9300K	Il monitor supporta una temperatura di colore di 9.300 K.
MC_SUPPORTED_COLOR_TEMPERATURE_10000K	Il monitor supporta una temperatura di colore di 10.000 K.
MC_SUPPORTED_COLOR_TEMPERATURE_11500K	Il monitor supporta una temperatura di colore di 11.500 K.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	highlevelmonitorconfigurationapi.h
Libreria	Dxva2.lib
DLL	Dxva2.dll

Vedi anche

Monitorare le funzioni di configurazione

Condividi tramite