DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION Rückruffunktion (dispmprt.h)
Wird vom Microsoft DirectX-Grafikkernsystem aufgerufen, um die Optimierungsebene festzulegen, die der Anzeige-Miniporttreiber zum Steuern der Helligkeit eines integrierten Anzeigebereichs verwendet.
Syntax
DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION DxgkBrightnessSetBacklightOptimization;
NTSTATUS DxgkBrightnessSetBacklightOptimization(
[in] PVOID Context,
[in] DXGK_BACKLIGHT_OPTIMIZATION_LEVEL OptimizationLevel
)
{...}
Parameter
[in] Context
Ein Handle für einen Kontextblock, der einer Grafikkarte zugeordnet ist. Die DxgkDdiAddDevice-Funktion des Display-Miniporttreibers hat dieses Handle zuvor für das DirectX-Grafikkernsubsystem bereitgestellt.
[in] OptimizationLevel
Ein Wert vom Typ DXGK_BACKLIGHT_OPTIMIZATION_LEVEL , der den Optimierungsgrad der Helligkeitssteuerung angibt.
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
Der Display-Miniporttreiber kann die Optimierungsebene der Hintergrundbeleuchtung des integrierten Anzeigebereichs basierend auf dem aktuellen Inhalt auf dem Bildschirm dynamisch ändern.
Der Treiber muss auf Anforderungen des Betriebssystems reagieren, um die Backlight-Optimierungsebene im Parameter OptimizationLevel zu ändern. Solche Anforderungen basieren auf Systemzustandsänderungen.
Nachdem der Treiber die adaptive Helligkeit auf dem Anzeigebereich als Reaktion auf einen Aufruf der DxgkDdiSetBrightnessState-Funktion aktiviert hat, darf er die adaptive Helligkeit nicht deaktivieren.
Wenn der Treiber von einer Hintergrundbeleuchtungsoptimierungsstufe zu einer anderen wechselt, sollte er einen allmählichen Übergang in den Helligkeitseinstellungen des integrierten Anzeigebereichs vornehmen. Ein wichtiges Beispiel für diese Art von Übergang ist, wenn ein Benutzer die Steuerelemente für die Videowiedergabe anpasst und das Betriebssystem reagiert, indem der Wert von OptimizationLevel von DxgkBacklightOptimizationDynamic auf DxgkBacklightOptimizationDesktop zurückgesetzt wird.
Das Anschließen zusätzlicher Anzeigegeräte an das System darf die Fähigkeit des Treibers, eine adaptive Helligkeitssteuerung auf dem integrierten Anzeigebereich auszuführen, nicht beeinträchtigen.
Diese Funktion sollte ausgelagert werden.
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 |