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.

ValueMeaning
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 http://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

See also

Backlight Control Interface
IOCTL_VIDEO_QUERY_DISPLAY_BRIGHTNESS
IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS

 

 

Show: