Funzione SetMonitorRedGreenOrBlueGain (highlevelmonitorconfigurationapi.h)

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.

Imposta il valore di guadagno rosso, verde o blu di un monitor.

Sintassi

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

Parametri

[in] hMonitor

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

[in] gtGainType

Membro dell'enumerazione MC_GAIN_TYPE , che specifica se impostare il guadagno rosso, verde o blu.

[in] dwNewGain

Valore di guadagno rosso, verde o blu. Per ottenere i valori di guadagno minimo e massimo del monitoraggio, chiamare GetMonitorRedGreenOrBlueGain.

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.

Commenti

Le impostazioni di guadagno vengono in genere usate per regolare il punto bianco del monitor.

Se questa funzione è supportata, la funzione GetMonitorCapabilities restituisce il flag MC_CAPS_RED_GREEN_BLUE_GAIN.

Per restituire questa funzione sono necessari circa 50 millisecondi.

La modifica delle impostazioni di guadagno può modificare la temperatura del colore. Per ottenere la nuova temperatura del colore, chiama GetMonitorColorTemperature.

Le impostazioni di guadagno sono impostazioni di monitoraggio continuo. Per altre informazioni, vedere Uso delle funzioni di configurazione di monitoraggio High-Level.

Requisiti

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