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. Version number constants are defined in Dispmprt.h (for example, DXGK_BRIGHTNESS_INTERFACE_VERSION_2).

[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 on this interface, see Brightness Control Interface V. 2 (Adaptive and Smooth Brightness Control).

Requirements

See also

DXGK_BRIGHTNESS_INTERFACE