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 exibição 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 miniporto de exibição anteriormente forneceu 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.
Valor de retorno
Retorna STATUS_SUCCESS se tiver êxito. Caso contrário, ele retornará um dos códigos de erro definidos em Ntstatus.h.
Observações
O driver de miniporto de exibição pode alterar dinamicamente o nível de otimização de backlight do painel de exibição integrado com base no conteúdo atual na tela.
O driver deve responder às solicitações do sistema operacional para alterar o nível de otimização do 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 deve 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 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 |
|---|---|
| de cliente com suporte mínimo | Windows 8 |
| servidor com suporte mínimo | Windows Server 2012 |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | dispmprt.h (inclua Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |