DXGK_BRIGHTNESS_GET_BACKLIGHT_REDUCTION función de devolución de llamada (dispmprt.h)
Recupera el nivel actual de reducción de retroiluminación que se aplica al panel de visualización integrado.
Sintaxis
DXGK_BRIGHTNESS_GET_BACKLIGHT_REDUCTION DxgkBrightnessGetBacklightReduction;
NTSTATUS DxgkBrightnessGetBacklightReduction(
[in] PVOID Context,
[out] DXGK_BACKLIGHT_INFO *BacklightInfo
)
{...}
Parámetros
[in] Context
Identificador de un bloque de contexto DxgkDdiAddDevice asociado a un adaptador de pantalla. La función del controlador de minipuerto de pantalla proporcionó anteriormente este identificador al subsistema del kernel de gráficos de DirectX.
[out] BacklightInfo
Valor de tipo DXGK_BACKLIGHT_INFO que proporciona el nivel absoluto actual de reducción de retroiluminación.
Valor devuelto
Devuelve STATUS_SUCCESS si se realiza correctamente. De lo contrario, devuelve uno de los códigos de error definidos en Ntstatus.h.
Comentarios
Esta función se usa principalmente con fines de depuración y pruebas para garantizar una experiencia de usuario de calidad con el panel de visualización. El controlador de minipuerto de pantalla siempre debe proporcionar información precisa sobre el panel de visualización integrado cuando se llama a esta función.
Tenga en cuenta que, para algún hardware, un valor de cero para BacklightInfo-BacklightUsersetting> o BacklightInfo-BacklightEffective> podría no corresponder a un nivel de brillo de Windows de cero por ciento. Por lo tanto, el sistema operativo requiere información de brillo absoluta que proporciona BacklightUsersetting y BacklightEffective. Si el hardware usa niveles de brillo de 0 a 255, debe multiplicar esos valores por 256 para asignarlos correctamente al rango de 0 a 65535 de BacklightUsersetting y BacklightEffective.
Esta función debe ser paginable.
Relación de reducción de retroiluminación informática
La relación de reducción de la luz trasera (BRR) se calcula como (BacklightUsersetting - BacklightEffective) / BacklightUsersetting.El sistema operativo supone que, en respuesta a una nueva solicitud de nivel de brillo, el controlador aumentará el brillo de píxeles por un factor de BacklightUsersetting / BacklightEffective = 1.0 / (1.0 - BRR).
Por ejemplo, si BRR = 0,2, el controlador normalmente aumentará el brillo por un factor de 1,0 / (1,0 - BRR) = 1,25, por lo que cualquier píxel con un valor de brillo superior a 255 * (1,0 - BRR) = 204 saturará. Con el valor de BacklightInfo-GammaRamp> proporcionado por el controlador, el sistema operativo puede calcular con mayor precisión la distorsión del brillo de píxeles para una imagen determinada.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 |
| Servidor mínimo compatible | Windows Server 2012 |
| Plataforma de destino | Escritorio |
| Encabezado | dispmprt.h (include Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |