DXGK_BRIGHTNESS_GET Rückruffunktion (dispmprt.h)
Die DxgkDdiGetBrightness-Funktion ruft die derzeit aktive Helligkeitsstufe eines integrierten Anzeigebereichs ab.
Syntax
DXGK_BRIGHTNESS_GET DxgkBrightnessGet;
NTSTATUS DxgkBrightnessGet(
[in] PVOID Context,
[in] PUCHAR 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
Ein Zeiger auf eine Variable, die die Helligkeitsstufe empfängt.
Rückgabewert
DxgkDdiGetBrightness gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird einer der Fehlercodes zurückgegeben, die in Ntstatus.h definiert sind.
Hinweise
Wenn der Monitortreiber initialisiert, kann er die DxgkDdiGetBrightness-Funktion des Anzeigeminiporttreibers aufrufen, um die Helligkeitsstufe abzurufen, die derzeit für den integrierten Anzeigebereich aktiv ist.
Da der Monitortreiber beim Starten oder Fortsetzen immer die Helligkeitsstufe für den integrierten Anzeigebereich abruft und alle Helligkeitsänderungen über den Monitortreiber gehen, sollte der aktuelle Helligkeitspegel für den Monitortreiber immer zwischengespeichert werden. Wenn Clients die aktuelle Helligkeitsstufe abfragen, wird der Pegel daher vom Monitortreiber und nicht vom Anzeigeminiporttreiber abgefragt.
DxgkDdiGetBrightness sollte als ausgelagert werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Zielplattform | Desktop |
| Kopfzeile | dispmprt.h (include Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |