Compartilhar via


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

A função DxgkDdiGetBrightness recupera o nível de brilho ativo atualmente de um painel de exibição integrado.

Sintaxe

DXGK_BRIGHTNESS_GET DxgkBrightnessGet;

NTSTATUS DxgkBrightnessGet(
  [in] PVOID Context,
  [in] PUCHAR Brightness
)
{...}

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 do Microsoft DirectX.

[in] Brightness

Um ponteiro para uma variável que recebe o nível de brilho.

Retornar valor

DxgkDdiGetBrightness retornará STATUS_SUCCESS se for bem-sucedido. Caso contrário, ele retornará um dos códigos de erro definidos em Ntstatus.h.

Comentários

Quando o driver de monitor é inicializado, ele pode chamar a função DxgkDdiGetBrightness do driver de miniporta de exibição para recuperar o nível de brilho que estará ativo no momento para o painel de exibição integrado.

Como o driver de monitor sempre obtém o nível de brilho do painel de exibição integrado na inicialização ou no currículo e todas as alterações no brilho passam pelo driver do monitor, o driver de monitor sempre deve ter o nível de brilho atual armazenado em cache. Portanto, quando os clientes consultam o nível de brilho atual, o nível é consultado do driver do monitor e não do driver de miniporte de exibição.

DxgkDdiGetBrightness deve se tornar paginável.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Plataforma de Destino Área de Trabalho
Cabeçalho dispmprt.h (inclua Dispmprt.h)
IRQL PASSIVE_LEVEL

Confira também

DxgkDdiAddDevice