DXGK_BRIGHTNESS_GET_BACKLIGHT_REDUCTION Rückruffunktion (dispmprt.h)

Ruft die aktuelle Stufe 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 für einen DxgkDdiAddDevice-Kontextblock , der einer Grafikkarte zugeordnet ist. Die Display-Miniporttreiberfunktion hat dieses Handle zuvor für das DirectX-Grafikkernsubsystem bereitgestellt.

[out] BacklightInfo

Ein Wert vom Typ DXGK_BACKLIGHT_INFO , der die aktuelle absolute Stufe der Hintergrundbeleuchtungsreduzierung bereitstellt.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn dies erfolgreich ist. Andernfalls wird einer der Fehlercodes zurückgegeben, die in Ntstatus.h definiert sind.

Hinweise

Diese Funktion wird hauptsächlich für Debug- und Testzwecke verwendet, um eine qualitativ hochwertige Benutzererfahrung mit dem Anzeigebereich zu gewährleisten. Der Display-Miniporttreiber muss immer genaue Informationen über den integrierten Anzeigebereich bereitstellen, wenn diese Funktion aufgerufen wird.

Beachten Sie, dass für einige Hardware der Wert 0 (null) für BacklightInfo-BacklightUsersetting> oder BacklightInfo-BacklightEffective (BacklightInfo-BacklightEffective) möglicherweise nicht einem Windows-Helligkeitsgrad> von null Prozent entspricht. Das Betriebssystem benötigt daher absolute Helligkeitsinformationen, die von BacklightUsersetting und BacklightEffective angegeben werden. Wenn die Hardware Helligkeitsstufen von 0 bis 255 verwendet, muss sie diese Werte mit 256 multiplizieren, um sie ordnungsgemäß dem Bereich von 0 bis 65535 von BacklightUsersetting und BacklightEffective zuzuordnen.

Diese Funktion sollte ausgelagert werden.

Berechnen des Verringerungsgrads der Hintergrundbeleuchtung

Die Rücklichtreduzierung (Backlight Reduction Ratio, BRR) wird als (BacklightUsersetting - BacklightEffective) / BacklightUsersetting berechnet.

Das Betriebssystem geht davon aus, dass der Treiber als Reaktion auf eine neue Anforderung der Helligkeitsstufe die Pixelhelligkeit um den Faktor BacklightUsersetting / BacklightEffective = 1,0 / (1,0 - BRR) erhöht.

Wenn BRR beispielsweise = 0,2 ist, erhöht der Treiber die Helligkeit in der Regel um den Faktor 1,0 / (1,0 - BRR) = 1,25, sodass jedes Pixel mit einem Helligkeitswert über 255 * (1,0 - BRR) = 204 gesättigt wird. Mithilfe des vom Treiber bereitgestellten Werts von BacklightInfo-GammaRamp> kann das Betriebssystem die Verzerrung der Pixelhelligkeit für ein bestimmtes Bild genauer schätzen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Desktop
Kopfzeile	dispmprt.h (include Dispmprt.h)
IRQL	PASSIVE_LEVEL

Weitere Informationen

DXGK_BACKLIGHT_INFO

DxgkDdiAddDevice