Compartilhar via


DXGK_BRIGHTNESS_GET_POSSIBLE função de retorno de chamada (dispmprt.h)

A função DxgkDdiGetPossibleBrightness recupera os níveis de brilho compatíveis com um painel de exibição integrado.

Sintaxe

DXGK_BRIGHTNESS_GET_POSSIBLE DxgkBrightnessGetPossible;

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

Parâmetros

[in] Context

[in] Um identificador para um bloco de contexto associado a um adaptador de exibição. A função DxgkDdiAddDevice do driver de miniporta de vídeo forneceu anteriormente esse identificador para o subsistema de kernel de elementos gráficos do Microsoft DirectX.

[in] BufferSize

[in] O tamanho, em bytes, do buffer passado no parâmetro BrightnessLevels .

[out] LevelCount

[out] Um ponteiro para uma variável que recebe o número de níveis de brilho que o driver retorna no buffer para o qual o parâmetro BrightnessLevels aponta.

[out] BrightnessLevels

[entrada/saída] Um ponteiro para um buffer que recebe os níveis de brilho aos quais um painel de exibição integrado dá suporte.

Retornar valor

DxgkDdiGetPossibleBrightness retornará STATUS_SUCCESS se tiver êxito. Caso contrário, ele retornará um dos códigos de erro definidos em Ntstatus.h.

Comentários

O driver de miniporta de exibição deve retornar níveis de brilho no buffer para o qual o parâmetro BrightnessLevels aponta na seguinte ordem:

  • O primeiro valor de nível de brilho é o nível de brilho que o BIOS usa quando o computador é executado na energia AC.
  • O segundo valor de nível de brilho é o nível de brilho que o BIOS usa quando o computador é executado na potência dc.
  • Os valores de nível de brilho restantes são níveis de brilho com suporte de hardware.
Para simplificar o trabalho de implementar um driver de miniporta de exibição, o sistema operacional fornece ao driver o buffer para o qual o parâmetro BrightnessLevels aponta.

DxgkDdiGetPossibleBrightness deve ser tornado paginável.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Plataforma de Destino Área de Trabalho
Cabeçalho dispmprt.h (inclua Dispmprt.h)
IRQL PASSIVE_LEVEL

Confira também

DxgkDdiAddDevice