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 |