DXGK_BRIGHTNESS_GET_POSSIBLE funzione di callback (dispmprt.h)

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 grafico Microsoft DirectX.

[in] BufferSize

[in] Dimensione, 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.

Commenti

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 i 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 paginabile.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Piattaforma di destinazione	Desktop
Intestazione	dispmprt.h (include Dispmprt.h)
IRQL	PASSIVE_LEVEL

Vedi anche

DxgkDdiAddDevice