DXGK_BRIGHTNESS_SET_STATE Rückruffunktion (dispmprt.h)
Ermöglicht eine reibungslose Helligkeitssteuerung auf einem integrierten Anzeigebereich.
Syntax
DXGK_BRIGHTNESS_SET_STATE DxgkBrightnessSetState;
NTSTATUS DxgkBrightnessSetState(
[in] PVOID Context,
[in] DXGK_BRIGHTNESS_STATE *BrightnessState
)
{...}
Parameter
[in] Context
Ein Handle für einen Kontextblock, der einem Anzeigeadapter zugeordnet ist. Die DxgkDdiAddDevice-Funktion des Anzeigeminiporttreibers hat dieses Handle zuvor für das DirectX-Grafikkernsubsystem bereitgestellt.
[in] BrightnessState
Ein Zeiger auf eine DXGK_BRIGHTNESS_STATE Struktur, die angibt, dass der Display-Miniporttreiber die Steuerung für die gleichmäßige Helligkeit für den integrierten Anzeigebereich aktivieren soll.
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
Damit das Betriebssystem die Bildschirmhelligkeit reibungslos anpassen kann, muss der Display-Miniporttreiber ab Windows 8 10 Helligkeitsstufen von 0 bis 100 Prozent melden. Bei einem Wert von 0 Prozent sollte der Bildschirminhalt für den Benutzer kaum sichtbar sein. Ein Wert von 100 Prozent ist die maximale Helligkeit, die das integrierte Display erzeugen kann. Treiber und Hardware können eine feinere Helligkeitssteuerung für interne Vorgänge unterstützen.
Wenn die DxgkDdiSetBrightness-Funktion aufgerufen wird, sollte der Treiber eine geeignete Steigung auswählen, um einen gleichmäßigen Helligkeitsübergang basierend auf den Paneleigenschaften zu ermöglichen, aber jeder Übergang muss in unter 500 Millisekunden abgeschlossen sein.
Diese Funktion sollte auslagerungsfähig gemacht 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 |