DISPLAY_BRIGHTNESS structure
Describes the brightness of the display device. This structure is used by the IOCTL_VIDEO_QUERY_DISPLAY_BRIGHTNESS and IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS control codes.
Syntax
typedef struct _DISPLAY_BRIGHTNESS {
UCHAR ucDisplayPolicy;
UCHAR ucACBrightness;
UCHAR ucDCBrightness;
} DISPLAY_BRIGHTNESS, *PDISPLAY_BRIGHTNESS;
Members
ucDisplayPolicy
The display policy. This member can be one of the following values.Value Meaning DISPLAYPOLICY_AC 0x00000001 AC power.
DISPLAYPOLICY_DC 0x00000002 DC power.
DISPLAYPOLICY_BOTH 0x00000003 Both AC and DC power. This value is valid only with IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS.
ucACBrightness
The AC brightness level. This is a value between 0 and 100. The larger the value, the brighter the backlight under AC power.ucDCBrightness
The DC brightness level. This is a value between 0 and 100. The larger the value, the brighter the backlight under DC power.
Remarks
When calling IOCTL_VIDEO_QUERY_DISPLAY_BRIGHTNESS, the ucDisplayPolicy parameter indicates the current power source, either AC or DC. When calling IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS, this parameter determines which brightness levels are set: AC, DC, or both.
The header file used to build applications that include this functionality, Ntddvdeo.h, is included in the Microsoft Windows Driver Development Kit (DDK). For information on obtaining the DDK, see https://www.microsoft.com/whdc/devtools/ddk/default.mspx.
Requirements
Minimum supported client |
Windows Vista, Windows XP with SP1 [desktop apps only] |
Minimum supported server |
Windows Server 2003 [desktop apps only] |
End of client support |
Windows 7 |
End of server support |
Windows Server 2008 R2 |
Header |
WinNT.h; Ntddvdeo.h |