Compartir a través de

DXGK_BRIGHTNESS_SET función de devolución de llamada (dispmprt.h)

  • Artículo

La función DxgkDdiSetBrightness establece un nuevo nivel de brillo.

Sintaxis

DXGK_BRIGHTNESS_SET DxgkBrightnessSet;

NTSTATUS DxgkBrightnessSet(
  [in] PVOID Context,
  [in] UCHAR Brightness
)
{...}

Parámetros

[in] Context

Identificador de un bloque de contexto asociado a un adaptador de pantalla. La función DxgkDdiAddDevice del controlador de miniporte de pantalla proporcionó anteriormente este identificador al subsistema del kernel de gráficos de Microsoft DirectX.

[in] Brightness

Valor de nivel de brillo que se va a establecer.

Valor devuelto

DxgkDdiSetBrightness devuelve STATUS_SUCCESS si se establece correctamente un nuevo nivel de brillo. De lo contrario, devuelve uno de los códigos de error definidos en Ntstatus.h.

Comentarios

El controlador de monitor llama a la función DxgkDdiSetBrightness del controlador de miniporte de pantalla para cambiar el nivel de brillo del panel de pantalla integrado por los siguientes motivos:

  • Las notificaciones del motor de directiva de energía del dispositivo (DPPE) indican que se modifica la directiva actual o que se aplica una nueva directiva. Una nueva directiva DPPE surte efecto en el inicio, reanudación y conmutador de usuario del sistema, así como cuando se cambia la fuente de alimentación.
  • La manera preferida para que los clientes en modo de usuario controlen el brillo es a través de Instrumental de administración de Windows (WMI). El controlador de monitor implementa los controles de brillo WMI que seleccionan un nivel de brillo o revierten el nivel de brillo al nivel seleccionado por la directiva DPPE activa actualmente. El método WMI para seleccionar un nivel de brillo invalida el nivel de directiva DPPE actual hasta que se produzca cualquier cambio en la directiva DPPE. Cuando cambia la directiva DPPE, se establece el nuevo nivel DPPE.
  • Por compatibilidad con el modelo de controlador de pantalla de Windows 2000, el controlador de monitor implementa IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS como una manera alternativa de que los clientes en modo de usuario controlen el brillo. Una llamada a IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS se controla de la misma manera que el control de brillo de WMI que selecciona un nivel de brillo.
  • El controlador de supervisión interpreta las notificaciones de teclas activas de brillo del controlador Advanced Configuration and Power Interface (ACPI) como solicitudes de usuario para cambiar el nivel de brillo actual. Al igual que con las interfaces de modo de usuario WMI e IOCTL, un cambio en el nivel de brillo desencadenado por una notificación de clave activa invalida la directiva DPPE actual y permanece vigente hasta que la directiva DPPE solicita que el valor de brillo se vuelva a establecer.
DxgkDdiSetBrightness debe ser paginable.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista
Plataforma de destino Escritorio
Encabezado dispmprt.h (include Dispmprt.h)
IRQL PASSIVE_LEVEL

Consulte también

DxgkDdiAddDevice

IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS