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

See also

Backlight Control Interface

IOCTL_VIDEO_QUERY_DISPLAY_BRIGHTNESS

IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS