Edit

Share via


DXGK_BRIGHTNESS_INTERFACE_2 structure (dispmprt.h)

The DXGK_BRIGHTNESS_INTERFACE_2 structure contains pointers to functions in the Panel Brightness Control Interface Version 2. Used by WDDM 1.2 and later kernel-mode display miniport drivers (KMDs) that support adaptive and smooth brightness control.

Syntax

typedef struct {
  [in]  IN USHORT                                      Size;
  [in]  IN USHORT                                      Version;
  [in]  OUT PVOID                                      Context;
  [out] OUT PINTERFACE_REFERENCE                       InterfaceReference;
  [out] OUT PINTERFACE_DEREFERENCE                     InterfaceDereference;
  [out] OUT DXGK_BRIGHTNESS_GET_POSSIBLE               GetPossibleBrightness;
  [out] OUT DXGK_BRIGHTNESS_SET                        SetBrightness;
  [out] OUT DXGK_BRIGHTNESS_GET                        GetBrightness;
  [out] OUT DXGK_BRIGHTNESS_GET_CAPS                   GetBrightnessCaps;
  [out] OUT DXGK_BRIGHTNESS_SET_STATE                  SetBrightnessState;
  [out] OUT DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION SetBacklightOptimization;
  [out] OUT DXGK_BRIGHTNESS_GET_BACKLIGHT_REDUCTION    GetBacklightReduction;
} DXGK_BRIGHTNESS_INTERFACE_2, *PDXGK_BRIGHTNESS_INTERFACE_2;

Members

[in] Size

The size, in bytes, of this structure.

[in] Version

The version number of the brightness interface. Must be set to DXGK_BRIGHTNESS_INTERFACE_VERSION_2 for this structure.Version number constants are defined in Dispmprt.h.

[in] Context

A pointer to a private context block.

[out] InterfaceReference

Pointer to a KMD-implemented interface reference function.

[out] InterfaceDereference

Pointer to a KMD-implemented interface dereference function.

[out] GetPossibleBrightness

A pointer to KMD's DxgkDdiGetPossibleBrightness function.

[out] SetBrightness

A pointer to KMD's DxgkDdiSetBrightness function.

[out] GetBrightness

A pointer to KMD's DxgkDdiGetBrightness function.

[out] GetBrightnessCaps

A pointer to KMD's DxgkDdiGetBrightnessCaps function. This function is available starting with Windows 8.

[out] SetBrightnessState

A pointer to KMD's DxgkDdiSetBrightnessState function. This function is available starting with Windows 8.

[out] SetBacklightOptimization

A pointer to KMD's DxgkDdiSetBacklightOptimization function. This function is available starting with Windows 8.

[out] GetBacklightReduction

A pointer to KMD's DxgkDdiGetBacklightReduction function. This function is available starting with Windows 8.

Remarks

This structure provides additional members, beyond those in the DXGK_BRIGHTNESS_INTERFACE interface, that point to driver-implemented functions that control, measure, and optimize display panel brightness and allow smooth brightness control.

For more information, see Supporting brightness controls on integrated display panels.

Requirements

Requirement Value
Minimum supported client Windows 8
Minimum supported server Windows Server 2012
Header dispmprt.h (include Dispmprt.h)

See also

DXGK_BRIGHTNESS_INTERFACE