DXGK_BRIGHTNESS_SET Rückruffunktion (dispmprt.h)

Artikel
02/06/2025

Die DxgkDdiSetBrightness--Funktion legt einen neuen Helligkeitsgrad fest.

Syntax

DXGK_BRIGHTNESS_SET DxgkBrightnessSet;

NTSTATUS DxgkBrightnessSet(
  [in] PVOID Context,
  [in] UCHAR Brightness
)
{...}

Parameter

[in] Context

Ein Handle zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Die DxgkDdiAddDevice-Funktion des Display-Miniporttreibers stellt dieses Handle zuvor für das Microsoft DirectX-Grafik-Kernel-Subsystem bereit.

[in] Brightness

Der festzulegende Wert der Helligkeitsstufe.

Rückgabewert

DxgkDdiSetBrightness gibt STATUS_SUCCESS zurück, wenn die Einstellung einer neuen Helligkeitsstufe erfolgreich ist. Andernfalls wird eine der fehlercodes zurückgegeben, die in ntstatus.hdefiniert sind.

Bemerkungen

Der Monitortreiber ruft die DxgkDdiSetBrightness-Funktion des Anzeigeminiporttreibers auf, um den Helligkeitsgrad des integrierten Anzeigebereichs aus den folgenden Gründen zu ändern:

Benachrichtigungen vom Device Power Policy Engine (DPPE) geben an, dass entweder die aktuelle Richtlinie geändert wird oder eine neue Richtlinie wirksam wird. Eine neue DPPE-Richtlinie wird beim Starten, Fortsetzen und Benutzerwechsel des Systems sowie beim Ändern der Stromversorgung wirksam.
Die bevorzugte Methode für Benutzermodusclients zum Steuern der Helligkeit ist die Windows-Verwaltungsinstrumentation (WMI). Der Monitortreiber implementiert die WMI-Helligkeitssteuerelemente, die eine Helligkeitsstufe auswählen oder die Helligkeitsstufe auf die Ebene zurücksetzen, die von der derzeit aktiven DPPE-Richtlinie ausgewählt wurde. Die WMI-Methode zum Auswählen einer Helligkeitsstufe setzt die aktuelle DPPE-Richtlinienstufe außer Kraft, bis eine Änderung der DPPE-Richtlinie erfolgt. Wenn sich die DPPE-Richtlinie ändert, wird die neue DPPE-Ebene festgelegt.
Aus Gründen der Kompatibilität mit dem Windows 2000 Display Driver Modelimplementiert der Monitortreiber IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS als alternative Möglichkeit für Benutzermodusclients zum Steuern der Helligkeit. Ein Aufruf von IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS wird auf die gleiche Weise behandelt wie das WMI-Helligkeitssteuerelement, das eine Helligkeitsstufe auswählt.
Der Monitortreiber interpretiert Benachrichtigungen über die Helligkeit von Hot-Key-Benachrichtigungen vom ACPI-Treiber (Advanced Configuration and Power Interface), da der Benutzer die aktuelle Helligkeitsstufe ändern möchte. Wie bei den WMI- und IOCTL-Benutzermodusschnittstellen setzt eine Änderung der Helligkeitsstufe, die durch eine Hot-Key-Benachrichtigung ausgelöst wird, die aktuelle DPPE-Richtlinie außer Kraft und bleibt wirksam, bis die DPPE-Richtlinie anfordert, dass der Helligkeitswert erneut festgelegt wird.

DxgkDdiSetBrightness sollte seitenfähig gemacht werden.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista
Zielplattform-	Desktop
Header-	dispmprt.h (include Dispmprt.h)
IRQL-	PASSIVE_LEVEL

Siehe auch

DxgkDdiAddDevice

IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS

Freigeben über