DXGK_BRIGHTNESS_GET_POSSIBLE funzione di callback (dispmprt.h)

Articolo
02/06/2025

La funzione DxgkDdiGetPossibleBrightness recupera i livelli di luminosità supportati da un pannello di visualizzazione integrato.

Sintassi

DXGK_BRIGHTNESS_GET_POSSIBLE DxgkBrightnessGetPossible;

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

Parametri

[in] Context

[in] Handle di un blocco di contesto associato a una scheda di visualizzazione. La funzione DxgkDdiAddDevice del driver miniport di visualizzazione ha fornito in precedenza questo handle al sottosistema kernel della grafica Microsoft DirectX.

[in] BufferSize

[in] Dimensioni, in byte, del buffer passato nel parametro BrightnessLevels.

[out] LevelCount

[out] Puntatore a una variabile che riceve il numero di livelli di luminosità restituiti dal driver nel buffer a cui punta il parametro BrightnessLevels.

[out] BrightnessLevels

[in/out] Puntatore a un buffer che riceve i livelli di luminosità supportati da un pannello di visualizzazione integrato.

Valore restituito

DxgkDdiGetPossibleBrightness restituisce STATUS_SUCCESS se ha esito positivo. In caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.

Osservazioni

Il driver miniport di visualizzazione deve restituire i livelli di luminosità nel buffer a cui punta il parametro BrightnessLevels nell'ordine seguente:

Il primo valore del livello di luminosità è il livello di luminosità usato dal BIOS quando il computer viene eseguito sull'alimentazione AC.
Il secondo valore del livello di luminosità è il livello di luminosità usato dal BIOS quando il computer viene eseguito sull'alimentazione del controller di dominio.
I valori rimanenti del livello di luminosità sono livelli di luminosità supportati dall'hardware.

Per semplificare il processo di implementazione di un driver miniport di visualizzazione, il sistema operativo fornisce al driver il buffer a cui punta il parametro BrightnessLevels.

dxgkDdiGetPossibleBrightness deve essere reso pageable.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista
piattaforma di destinazione	Desktop
intestazione	dispmprt.h (include Dispmprt.h)
IRQL	PASSIVE_LEVEL

Vedere anche

DxgkDdiAddDevice

Condividi tramite