Funzione GetMonitorCapabilities (highlevelmonitorconfigurationapi.h)
Avviso
Le funzioni di configurazione del monitoraggio fisico funzionano usando lo standard MCCS (VESA Monitor Control Set) su un'interfaccia I2C. 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 |