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

Confira também

DXGK_BACKLIGHT_OPTIMIZATION_LEVEL

DxgkDdiAddDevice

DxgkDdiSetBrightnessState