DXGK_BRIGHTNESS_SET Rückruffunktion (dispmprt.h)
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Zielplattform | Desktop |
| Kopfzeile | dispmprt.h (include Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |