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

Recupera o nível atual de redução de luz de fundo que é aplicado ao painel de exibição integrado.

Sintaxe

DXGK_BRIGHTNESS_GET_BACKLIGHT_REDUCTION DxgkBrightnessGetBacklightReduction;

NTSTATUS DxgkBrightnessGetBacklightReduction(
  [in]  PVOID Context,
  [out] DXGK_BACKLIGHT_INFO *BacklightInfo
)
{...}

Parâmetros

[in] Context

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

[out] BacklightInfo

Um valor do tipo DXGK_BACKLIGHT_INFO que fornece o nível absoluto atual de redução da luz de fundo.

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

Essa função é usada principalmente para fins de depuração e teste para garantir uma experiência de usuário de qualidade com o painel de exibição. O driver de miniporta de exibição sempre deve fornecer informações precisas sobre o painel de exibição integrado quando essa função é chamada.

Observe que, para algum hardware, um valor zero para BacklightInfo-BacklightUsersetting > ou BacklightInfo-BacklightEffective> pode não corresponder a um nível de brilho do Windows de zero por cento. Portanto, o sistema operacional requer informações absolutas de brilho fornecidas por BacklightUsersetting e BacklightEffective. Se o hardware usar níveis de brilho de 0 a 255, ele deverá multiplicar esses valores por 256 para mapeá-los corretamente para o intervalo de 0 a 65535 de BacklightUsersetting e BacklightEffective.

Essa função deve ser tornada paginável.

Taxa de redução de luz de fundo de computação

A taxa de redução de luz de fundo (BRR) é calculada como (BacklightUsersetting - BacklightEffective) / BacklightUsersetting.

O sistema operacional pressupõe que, em resposta a uma nova solicitação de nível de brilho, o driver aumentará o brilho do pixel por um fator de BacklightUsersetting / BacklightEffective = 1,0 / (1,0 – BRR).

Por exemplo, se BRR = 0,2, o driver normalmente aumentará o brilho em um fator de 1,0 / (1,0 - BRR) = 1,25, portanto, qualquer pixel com um valor de brilho acima de 255 * (1,0 - BRR) = 204 saturará. Usando o valor de BacklightInfo-GammaRamp> fornecido pelo driver, o sistema operacional pode estimar com mais precisão a distorção do brilho do pixel para uma imagem específica.

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_INFO

DxgkDdiAddDevice