DXGK_BRIGHTNESS_INTERFACE_3 - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// dispmprt.h

typedef struct {
  [in]  IN USHORT                                        Size;
  [in]  IN USHORT                                        Version;
  [out] OUT PVOID                                        Context;
  [out] OUT PINTERFACE_REFERENCE                         InterfaceReference;
  [out] OUT PINTERFACE_DEREFERENCE                       InterfaceDereference;
  [out] OUT DXGK_BRIGHTNESS_SET_3                        SetBrightness;
  [out] OUT DXGK_BRIGHTNESS_GET_3                        GetBrightness;
  [out] OUT DXGK_BRIGHTNESS_GET_CAPS_3                   GetBrightnessCaps;
  [out] OUT DXGK_BRIGHTNESS_GET_NIT_RANGES               GetNitRanges;
  [out] OUT DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION_3 SetBacklightOptimization;
} DXGK_BRIGHTNESS_INTERFACE_3, *PDXGK_BRIGHTNESS_INTERFACE_3;
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (ns-dispmprt-dxgk_brightness_interface_3)

Description

The DXGK_BRIGHTNESS_INTERFACE_3 structure contains pointers to the kernel-mode display driver's (KMD) functions for Version 3 of the Panel Brightness Control Interface.

Members

Size [in]

The size, in bytes, of this structure.

Version [in]

The version number of the brightness interface. Must be set to DXGK_BRIGHTNESS_INTERFACE_VERSION_3. Version number constants are defined in Dispmprt.h.

Context [out]

A pointer to a private context block.

InterfaceReference [out]

A pointer to an interface reference function that is implemented by the KMD.

InterfaceDereference [out]

A pointer to an interface dereference function that is implemented by the KMD.

SetBrightness [out]

A pointer to the KMD's DxgkDdiSetBrightness3 function.

GetBrightness [out]

A pointer to the KMD's DxgkDdiGetBrightness3 function.

GetBrightnessCaps [out]

A pointer to the KMD's DxgkDdiGetBrightnessCaps3 function. This function is available starting with Windows 10.

GetNitRanges [out]

A pointer to the KMD's DxgkDdiGetNitRanges function. This function is available starting with Windows 10.

SetBacklightOptimization [out]

A pointer to the KMD's DxgkBrightnessSetBacklightOptimization3 function. This function is available starting with Windows 10.

Remarks

Version 3 is used by Windows Display Driver Model (WDDM) 2.4 and later KMDs that support multiple displays that can be set to calibrated nit-based brightness levels.

A kernel-mode component such as Dxgkrnl that must use the brightness interface initiates a call to the KMD's DxgkDdiQueryInterface function to retrieve the interface and passes a GUID_DEVINTERFACE_BRIGHTNESS_3 in the InterfaceType member of the QUERY_INTERFACE structure that the QueryInterface parameter points to.

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

See also

DXGK_BRIGHTNESS_INTERFACE_2

DXGK_BRIGHTNESS_INTERFACE

DxgkDdiGetBrightness3

DxgkDdiGetPossibleBrightness

DxgkddiQueryInterface

DxgkDdiSetBrightness3

QUERY_INTERFACE