DXGK_BRIGHTNESS_GET_BACKLIGHT_REDUCTION funzione di callback (dispmprt.h)

Recupera il livello corrente di riduzione della backlight applicato al pannello di visualizzazione integrato.

Sintassi

DXGK_BRIGHTNESS_GET_BACKLIGHT_REDUCTION DxgkBrightnessGetBacklightReduction;

NTSTATUS DxgkBrightnessGetBacklightReduction(
  [in]  PVOID Context,
  [out] DXGK_BACKLIGHT_INFO *BacklightInfo
)
{...}

Parametri

[in] Context

Handle per un blocco di contesto DxgkDdiAddDevice associato a una scheda di visualizzazione. La funzione del driver miniport di visualizzazione ha fornito in precedenza questo handle al sottosistema kernel della grafica DirectX.

[out] BacklightInfo

Valore di tipo DXGK_BACKLIGHT_INFO che fornisce il livello assoluto corrente di riduzione della backlight.

Valore restituito

Restituisce STATUS_SUCCESS se ha esito positivo. In caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.

Commenti

Questa funzione viene usata principalmente a scopo di debug e test per garantire un'esperienza utente di qualità con il pannello di visualizzazione. Il driver miniport di visualizzazione deve sempre fornire informazioni accurate sul pannello di visualizzazione integrato quando questa funzione viene chiamata.

Si noti che per alcuni hardware un valore pari a zero per BacklightInfo-BacklightUsersetting> oBacklightInfo-BacklightEffective> potrebbe non corrispondere a un livello di luminosità di Windows pari a zero%. Il sistema operativo richiede quindi informazioni di luminosità assoluta fornite da BacklightUsersetting e BacklightEffective. Se l'hardware usa i livelli di luminosità da 0 a 255, deve moltiplicare tali valori per 256 per eseguirne correttamente il mapping all'intervallo da 0 a 65535 di BacklightUsersetting e BacklightEffective.

Questa funzione deve essere resa pageable.

Calcolo del rapporto di riduzione della backlight

Il rapporto di riduzione della luce posteriore (BRR) viene calcolato come (BacklightUsersettingBacklightEffective) /BacklightUsersetting - .

Il sistema operativo presuppone che, in risposta a una nuova richiesta di livello di luminosità, il driver aumenterà la luminosità dei pixel in base a un fattore di BacklightUsersetting / BacklightEffective = 1,0 / (1,0 - BRR).

Ad esempio, se BRR = 0,2, il driver in genere aumenta la luminosità di un fattore di 1,0 / (1,0 - BRR) = 1,25, quindi qualsiasi pixel con un valore di luminosità superiore a 255 * (1,0 - BRR) = 204 saturazione. Usando il valore di BacklightInfo-GammaRamp> fornito dal driver, il sistema operativo può stimare in modo più accurato la distorsione della luminosità dei pixel per una determinata immagine.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Desktop
Intestazione	dispmprt.h (include Dispmprt.h)
IRQL	PASSIVE_LEVEL

Vedi anche

DXGK_BACKLIGHT_INFO

DxgkDdiAddDevice