DXGK_BRIGHTNESS_GET_BACKLIGHT_REDUCTION Rückruffunktion (dispmprt.h)
Ruft die aktuelle Ebene der Hintergrundbeleuchtungsreduzierung ab, die auf den integrierten Anzeigebereich angewendet wird.
Syntax
DXGK_BRIGHTNESS_GET_BACKLIGHT_REDUCTION DxgkBrightnessGetBacklightReduction;
NTSTATUS DxgkBrightnessGetBacklightReduction(
[in] PVOID Context,
[out] DXGK_BACKLIGHT_INFO *BacklightInfo
)
{...}
Parameter
[in] Context
Ein Handle zu einem DxgkDdiAddDevice Kontextblock, der einem Anzeigeadapter zugeordnet ist. Die Funktion des Miniporttreibers, die zuvor dieses Handle für das DirectX-Grafik-Kernelsubsystem bereitgestellt hat.
[out] BacklightInfo
Ein Wert vom Typ DXGK_BACKLIGHT_INFO, der die aktuelle absolute Ebene der Rücklichtreduzierung bereitstellt.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn dies erfolgreich ist. Andernfalls wird eine der Fehlercodes zurückgegeben, die in Ntstatus.h definiert sind.
Bemerkungen
Diese Funktion wird hauptsächlich für Debugging- und Testzwecke verwendet, um eine qualitativ hochwertige Benutzererfahrung mit dem Anzeigebereich sicherzustellen. Der Miniporttreiber muss immer genaue Informationen zum integrierten Anzeigebereich bereitstellen, wenn diese Funktion aufgerufen wird.
Beachten Sie, dass für einige Hardware ein Wert von Null für BacklightInfo-->BacklightUsersetting oder BacklightInfo-->BacklightEffective möglicherweise nicht einer Windows-Helligkeitsstufe von null Prozent entspricht. Das Betriebssystem erfordert daher absolute Helligkeitsinformationen, die von BacklightUsersetting und BacklightEffectiveangegeben werden. Wenn die Hardware Helligkeitsstufen von 0 bis 255 verwendet, muss sie diese Werte mit 256 multiplizieren, um sie dem Bereich von 0 bis 65535 BacklightUsersetting und BacklightEffective-korrekt zuzuordnen.
Diese Funktion sollte seitenfähig gemacht werden.
Computing Backlight Reduction Ratio
Das Backlight Reduction Ratio (BRR) wird als (BacklightUsersetting - BacklightEffective) / BacklightUsersettingberechnet.Das Betriebssystem geht davon aus, dass der Treiber als Reaktion auf eine neue Anforderung der Helligkeitsstufe die Pixelhelligkeit um einen Faktor BacklightUsersetting / BacklightEffective = 1,0 / (1,0 - BRR) erhöht.
Wenn beispielsweise BRR = 0,2, erhöht der Treiber normalerweise die Helligkeit um den Faktor 1,0 / (1,0 - BRR) = 1,25, sodass jedes Pixel mit einem Helligkeitswert über 255 * (1,0 - BRR) = 204 sättigungt. Mit dem Wert von BacklightInfo-–>GammaRamp- vom Treiber bereitgestellt, kann das Betriebssystem die Verzerrung der Pixelhelligkeit für ein bestimmtes Bild genauer abschätzen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 |
| mindestens unterstützte Server- | Windows Server 2012 |
| Zielplattform- | Desktop |
| Header- | dispmprt.h (include Dispmprt.h) |
| IRQL- | PASSIVE_LEVEL |