Freigeben über


DXGK_BRIGHTNESS_GET_POSSIBLE Rückruffunktion (dispmprt.h)

Die DxgkDdiGetPossibleBrightness-Funktion ruft die Helligkeitsstufen ab, die von einem integrierten Anzeigebereich unterstützt werden.

Syntax

DXGK_BRIGHTNESS_GET_POSSIBLE DxgkBrightnessGetPossible;

NTSTATUS DxgkBrightnessGetPossible(
  [in]  PVOID Context,
  [in]  ULONG BufferSize,
  [out] PUCHAR LevelCount,
  [out] PUCHAR BrightnessLevels
)
{...}

Parameter

[in] Context

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

[in] BufferSize

[in] Die Größe des Puffers in Bytes, der im Parameter BrightnessLevels übergeben wird.

[out] LevelCount

[out] Ein Zeiger auf eine Variable, die die Anzahl der Helligkeitsstufen empfängt, die der Treiber im Puffer zurückgibt, auf den der BrightnessLevels-Parameter verweist.

[out] BrightnessLevels

[ein/aus] Ein Zeiger auf einen Puffer, der die Von einem integrierten Anzeigebereich unterstützten Helligkeitsstufen empfängt.

Rückgabewert

DxgkDdiGetPossibleBrightness gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird einer der Fehlercodes zurückgegeben, die in Ntstatus.h definiert sind.

Hinweise

Der Display-Miniporttreiber sollte Helligkeitsstufen im Puffer zurückgeben, auf die der BrightnessLevels-Parameter in der folgenden Reihenfolge verweist:

  • Der erste Helligkeitswert ist die Helligkeitsstufe, die das BIOS verwendet, wenn der Computer mit Netzstrom ausgeführt wird.
  • Der zweite Wert der Helligkeitsstufe ist die Helligkeitsstufe, die das BIOS verwendet, wenn der Computer mit Gleichstrom ausgeführt wird.
  • Die verbleibenden Helligkeitsstufenwerte sind hardwaregestützte Helligkeitsstufen.
Um die Implementierung eines Anzeigeminiporttreibers zu vereinfachen, stellt das Betriebssystem dem Treiber den Puffer bereit, auf den der BrightnessLevels-Parameter verweist.

DxgkDdiGetPossibleBrightness sollte seitenfähig gemacht werden.

Anforderungen

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

Weitere Informationen

DxgkDdiAddDevice