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

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

Weitere Informationen

DXGK_BACKLIGHT_INFO

DxgkDdiAddDevice