Partilhar via


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

Recupera o nível atual de redução do backlight 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 DxgkDdiAddDevice bloco de contexto associado a um adaptador de exibição. A função do driver de miniporto 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 do backlight.

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

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 miniporto de exibição deve sempre fornecer informações precisas sobre o painel de exibição integrado quando essa função é chamada.

Observe que, para alguns hardwares, 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 de brilho absolutas fornecidas pelo 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 do backlight de computação

A taxa de redução do backlight (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 fornecidas 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
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

Consulte também

DXGK_BACKLIGHT_INFO

DxgkDdiAddDevice