DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION Rückruffunktion (dispmprt.h)
Vom Microsoft DirectX-Grafik-Kernelsubsystem aufgerufen, um die Optimierungsebene festzulegen, die der Display-Miniporttreiber verwendet, um die Helligkeit eines integrierten Anzeigebereichs zu steuern.
Syntax
DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION DxgkBrightnessSetBacklightOptimization;
NTSTATUS DxgkBrightnessSetBacklightOptimization(
[in] PVOID Context,
[in] DXGK_BACKLIGHT_OPTIMIZATION_LEVEL OptimizationLevel
)
{...}
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 DirectX-Grafik-Kernel-Subsystem bereit.
[in] OptimizationLevel
Ein Wert vom Typ DXGK_BACKLIGHT_OPTIMIZATION_LEVEL, der den Optimierungsgrad der Helligkeitssteuerung angibt.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn dies erfolgreich ist. Andernfalls wird eine der Fehlercodes zurückgegeben, die in Ntstatus.h definiert sind.
Bemerkungen
Der Display-Miniporttreiber kann den Optimierungsgrad der Hintergrundbeleuchtung des integrierten Anzeigebereichs basierend auf dem aktuellen Inhalt auf dem Bildschirm dynamisch ändern.
Der Treiber muss auf Anforderungen des Betriebssystems reagieren, um die Backlight-Optimierungsebene im parameter OptimizationLevel zu ändern. Solche Anforderungen basieren auf Systemstatusänderungen.
Nachdem der Treiber die adaptive Helligkeit im Anzeigebereich als Reaktion auf einen Aufruf des DxgkDdiSetBrightnessState-Funktion aktiviert hat, darf die adaptive Helligkeit nicht deaktiviert werden.
Wenn der Treiber von einer Backlight-Optimierungsebene zu einer anderen wechselt, sollte er einen allmählichen Übergang in den Helligkeitseinstellungen des integrierten Anzeigebereichs vornehmen. Ein wichtiges Beispiel für diesen Übergangstyp ist, wenn ein Benutzer die Steuerelemente für die Videowiedergabe anpasst und das Betriebssystem reagiert, indem der Wert von OptimizationLevel von DxgkBacklightOptimizationDynamic auf DxgkBacklightOptimizationDesktopzurückgesetzt wird.
Das Verbinden zusätzlicher Anzeigegeräte mit dem System darf nicht die Fähigkeit des Treibers beeinträchtigen, adaptive Helligkeitssteuerung auf dem integrierten Anzeigebereich durchzuführen.
Diese Funktion sollte seitenfähig gemacht werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 |
| mindestens unterstützte Server- | Windows Server 2012 |
| Zielplattform- | Desktop |
| Header- | dispmprt.h (include Dispmprt.h) |
| IRQL- | PASSIVE_LEVEL |