Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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.
Syntax
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;
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_3. Version number constants are defined in Dispmprt.h.
[out] Context
A pointer to a private context block.
[out] InterfaceReference
A pointer to an interface reference function that is implemented by the KMD.
[out] InterfaceDereference
A pointer to an interface dereference function that is implemented by the KMD.
[out] SetBrightness
A pointer to the KMD's DxgkDdiSetBrightness3 function.
[out] GetBrightness
A pointer to the KMD's DxgkDdiGetBrightness3 function.
[out] GetBrightnessCaps
A pointer to the KMD's DxgkDdiGetBrightnessCaps3 function. This function is available starting with Windows 10.
[out] GetNitRanges
A pointer to the KMD's DxgkDdiGetNitRanges function. This function is available starting with Windows 10.
[out] SetBacklightOptimization
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.
Requirements
| Requirement | Value |
|---|---|
| Header | dispmprt.h |