DXGK_BRIGHTNESS_SET Rückruffunktion (dispmprt.h)

  • Artikel

Die DxgkDdiSetBrightness-Funktion legt eine neue Helligkeitsstufe fest.

Syntax

DXGK_BRIGHTNESS_SET DxgkBrightnessSet;

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

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 Microsoft DirectX-Grafikkernsystem bereitgestellt.

[in] Brightness

Der festzulegende Wert der Helligkeitsstufe.

Rückgabewert

DxgkDdiSetBrightness gibt STATUS_SUCCESS zurück, wenn es erfolgreich ist, eine neue Helligkeitsstufe festzulegen. Andernfalls wird einer der in Ntstatus.h definierten Fehlercodes zurückgegeben.

Hinweise

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

  • Benachrichtigungen von der Device Power Policy Engine (DPPE) weisen darauf hin, dass entweder die aktuelle Richtlinie geändert wurde oder eine neue Richtlinie wirksam wird. Eine neue DPPE-Richtlinie wird beim Starten, Fortsetzen und Wechseln des Benutzers sowie beim Ändern der Energiequelle wirksam.
  • Die bevorzugte Methode für Clients im Benutzermodus 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 rückgängig machen, die von der derzeit aktiven DPPE-Richtlinie ausgewählt wurde. Die WMI-Methode zum Auswählen einer Helligkeitsstufe überschreibt die aktuelle DPPE-Richtlinienebene, bis änderungen an der DPPE-Richtlinie auftreten. Wenn sich die DPPE-Richtlinie ändert, wird die neue DPPE-Ebene festgelegt.
  • Aus Gründen der Kompatibilität mit dem Windows 2000-Anzeigetreibermodell implementiert der Monitortreiber IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS als alternative Möglichkeit für Benutzermodusclients, um die Helligkeit zu steuern. Ein Aufruf von IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS wird genauso behandelt wie das WMI-Helligkeitssteuerelement, das eine Helligkeitsstufe auswählt.
  • Der Monitortreiber interpretiert Helligkeitsbenachrichtigungen vom ACPI-Treiber (Advanced Configuration and Power Interface) als Benutzeranforderungen, die aktuelle Helligkeitsstufe zu ändern. Wie bei den WMI- und IOCTL-Benutzermodusschnittstellen überschreibt eine Änderung der Helligkeitsstufe, die durch eine Hot-Key-Benachrichtigung ausgelöst wird, die aktuelle DPPE-Richtlinie und bleibt in Kraft, bis die DPPE-Richtlinie anfordert, dass der Helligkeitswert erneut festgelegt wird.
DxgkDdiSetBrightness sollte als ausgelagert werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Kopfzeile dispmprt.h (include Dispmprt.h)
IRQL PASSIVE_LEVEL

Weitere Informationen

DxgkDdiAddDevice

IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS