DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION função de retorno de chamada (dispmprt.h)
Chamado pelo subsistema de kernel de elementos gráficos do Microsoft DirectX para definir o nível de otimização que o driver de miniporto de vídeo usa para controlar o brilho de um painel de exibição integrado.
Sintaxe
DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION DxgkBrightnessSetBacklightOptimization;
NTSTATUS DxgkBrightnessSetBacklightOptimization(
[in] PVOID Context,
[in] DXGK_BACKLIGHT_OPTIMIZATION_LEVEL OptimizationLevel
)
{...}
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 exibição forneceu anteriormente esse identificador para o subsistema de kernel de elementos gráficos DirectX.
[in] OptimizationLevel
Um valor do tipo DXGK_BACKLIGHT_OPTIMIZATION_LEVEL que indica o nível de otimização do controle de brilho.
Retornar valor
Retorna STATUS_SUCCESS se for bem-sucedido. Caso contrário, ele retornará um dos códigos de erro definidos em Ntstatus.h.
Comentários
O driver de miniporta de exibição pode alterar dinamicamente o nível de otimização de luz de fundo do painel de exibição integrado com base no conteúdo atual na tela.
O driver deve responder a solicitações do sistema operacional para alterar o nível de otimização de backlight no parâmetro OptimizationLevel . Essas solicitações são baseadas em alterações de estado do sistema.
Depois que o driver tiver habilitado o brilho adaptável no painel de exibição em resposta a uma chamada para a função DxgkDdiSetBrightnessState , ele não deverá desabilitar o brilho adaptável.
Quando o driver faz a transição de um nível de otimização de backlight para outro, ele deve fazer uma transição gradual nas configurações de brilho do painel de exibição integrado. Um exemplo importante desse tipo de transição é quando um usuário ajusta os controles de reprodução de vídeo e o sistema operacional responde redefinindo o valor de OptimizationLevel de DxgkBacklightOptimizationDynamic para DxgkBacklightOptimizationDesktop.
A conexão de dispositivos de exibição adicionais ao sistema não deve comprometer a capacidade do driver de executar o controle de brilho adaptável no painel de exibição integrado.
Essa função deve ser tornada paginável.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 |
| Servidor mínimo com suporte | Windows Server 2012 |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | dispmprt.h (inclua Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |