Partilhar via


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

A função DxgkDdiGetPossibleBrightness recupera os níveis de brilho compatíveis com um painel de exibição integrado.

Sintaxe

DXGK_BRIGHTNESS_GET_POSSIBLE DxgkBrightnessGetPossible;

NTSTATUS DxgkBrightnessGetPossible(
  [in]  PVOID Context,
  [in]  ULONG BufferSize,
  [out] PUCHAR LevelCount,
  [out] PUCHAR BrightnessLevels
)
{...}

Parâmetros

[in] Context

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

[in] BufferSize

[in] O tamanho, em bytes, do buffer passado no parâmetro BrightnessLevels.

[out] LevelCount

[out] Um ponteiro para uma variável que recebe o número de níveis de brilho que o driver retorna no buffer para o qual o parâmetro BrightnessLevels aponta.

[out] BrightnessLevels

[entrada/saída] Um ponteiro para um buffer que recebe os níveis de brilho compatíveis com um painel de exibição integrado.

Valor de retorno

DxgkDdiGetPossibleBrightness retornará STATUS_SUCCESS se tiver êxito. Caso contrário, ele retornará um dos códigos de erro definidos em Ntstatus.h.

Observações

O driver de miniporto de exibição deve retornar níveis de brilho no buffer para o qual o parâmetro BrightnessLevels aponta na seguinte ordem:

  • O primeiro valor de nível de brilho é o nível de brilho que o BIOS usa quando o computador é executado na potência ac.
  • O segundo valor de nível de brilho é o nível de brilho que o BIOS usa quando o computador é executado na potência dc.
  • Os valores de nível de brilho restantes são níveis de brilho compatíveis com hardware.
Para simplificar o trabalho de implementar um driver de miniporto de exibição, o sistema operacional fornece ao driver o buffer ao qual o parâmetro BrightnessLevels aponta.

DxgkDdiGetPossibleBrightness deve ser tornada paginável.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista
da Plataforma de Destino Área de trabalho
cabeçalho dispmprt.h (inclua Dispmprt.h)
IRQL PASSIVE_LEVEL

Consulte também

DxgkDdiAddDevice