// 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 referenceNo description available.
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.
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.
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.