Compartilhar via

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

  • Artigo

A função DxgkDdiSetBrightness define um novo nível de brilho.

Sintaxe

DXGK_BRIGHTNESS_SET DxgkBrightnessSet;

NTSTATUS DxgkBrightnessSet(
  [in] PVOID Context,
  [in] UCHAR Brightness
)
{...}

Parâmetros

[in] Context

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] Brightness

O valor do nível de brilho a ser definido.

Retornar valor

DxgkDdiSetBrightness retornará STATUS_SUCCESS se tiver êxito na definição de um novo nível de brilho. Caso contrário, ele retornará um dos códigos de erro definidos em Ntstatus.h.

Comentários

O driver do monitor chama a função DxgkDdiSetBrightness do driver de miniporta de exibição para alterar o nível de brilho do painel de exibição integrado pelos seguintes motivos:

  • As notificações do DPPE (Mecanismo de Política de Energia do Dispositivo) indicam que a política atual foi modificada ou uma nova política entra em vigor. Uma nova política DPPE entra em vigor na inicialização, retomada e alternância de usuário do sistema, bem como quando a fonte de energia é alterada.
  • A maneira preferencial para os clientes no modo de usuário controlarem o brilho é por meio da WMI (Instrumentação de Gerenciamento do Windows). O driver do monitor implementa os controles de brilho WMI que selecionam um nível de brilho ou reverter o nível de brilho para o nível selecionado pela política DPPE ativa no momento. O método WMI para selecionar um nível de brilho substitui o nível de política DPPE atual até que ocorra qualquer alteração na política DPPE. Quando a política DPPE é alterada, o novo nível DPPE é definido.
  • Para compatibilidade com o Modelo de Driver de Vídeo do Windows 2000, o driver de monitor implementa IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS como uma maneira alternativa para os clientes do modo de usuário controlarem o brilho. Uma chamada para IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS é tratada da mesma maneira que o controle de brilho WMI que seleciona um nível de brilho.
  • O driver do monitor interpreta as notificações de teclas de acesso de brilho do driver ACPI (Advanced Configuration and Power Interface) como solicitações do usuário para alterar o nível de brilho atual. Assim como acontece com as interfaces do modo de usuário WMI e IOCTL, uma alteração no nível de brilho disparada por uma notificação de tecla de acesso substitui a política DPPE atual e permanece em vigor até que a política DPPE solicite que o valor de brilho seja definido novamente.
DxgkDdiSetBrightness 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

IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS