DXGK_BRIGHTNESS_GET_CAPS Rückruffunktion (dispmprt.h)

  • Artikel

Ruft Helligkeitssteuerungsfunktionen eines integrierten Anzeigebereichs ab.

Syntax

DXGK_BRIGHTNESS_GET_CAPS DxgkBrightnessGetCaps;

NTSTATUS DxgkBrightnessGetCaps(
  [in] PVOID Context,
  [in] DXGK_BRIGHTNESS_CAPS *BrightnessCaps
)
{...}

Parameter

[in] Context

Ein Handle für einen Kontextblock, der einem Anzeigeadapter zugeordnet ist. Die DxgkDdiAddDevice-Funktion des Anzeigeminiporttreibers hat dieses Handle zuvor für das DirectX-Grafikkernsubsystem bereitgestellt.

[in] BrightnessCaps

Ein Zeiger auf eine DXGK_BRIGHTNESS_CAPS Struktur, die die Helligkeitssteuerungsfunktionen des Anzeigebereichs darstellt.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn dies erfolgreich ist. Andernfalls wird einer der Fehlercodes zurückgegeben, die in Ntstatus.h definiert sind.

Hinweise

Mit dieser Funktion kann der Display-Miniporttreiber unabhängig seine Unterstützung für die adaptive Helligkeitssteuerung und/oder die glatte Helligkeitssteuerung angeben.

Wenn die Hardware einen Umgebungslichtsensor enthält, muss sie eine gleichmäßige Helligkeitssteuerung unterstützen. Der Display-Miniporttreiber, kein eingebetteter Controller, muss die reibungslose Helligkeit des integrierten Anzeigebereichs steuern.

Wenn der Treiber durch ein PnP-Ereignis (Plug & Play) gestartet wird, muss er reibungslos von der anfänglichen Helligkeitsstufe, die von der Firmware festgelegt wird, auf die vom Betriebssystem festgelegte Ebene übergehen. Wenn zusätzliche Geräte mit dem System verbunden sind, dürfen sie die Fähigkeit des Fahrers, eine reibungslose Helligkeitssteuerung auf dem integrierten Anzeigebereich durchzuführen, nicht beeinträchtigen.

Der Treiber muss weiterhin eine reibungslose Helligkeitssteuerung unterstützen, auch wenn die adaptive Helligkeitssteuerung initiiert wird.

Diese Funktion sollte auslagerungsfähig gemacht werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8
Unterstützte Mindestversion (Server) Windows Server 2012
Zielplattform Desktop
Kopfzeile dispmprt.h (include Dispmprt.h)
IRQL PASSIVE_LEVEL

Weitere Informationen

DXGK_BRIGHTNESS_CAPS

DxgkDdiAddDevice