DXGK_BRIGHTNESS_GET_CAPS_3 callback function (dispmprt.h)

Implemented by the client driver to retrieve the brightness control capabilities of an integrated display panel.

Syntax

DXGK_BRIGHTNESS_GET_CAPS_3 DxgkBrightnessGetCaps3;

NTSTATUS DxgkBrightnessGetCaps3(
  [in]  PVOID Context,
  [in]  ULONG ChildUid,
  [out] DXGK_BRIGHTNESS_CAPS *pBrightnessCaps
)
{...}

Parameters

[in] Context

A handle to a context block that is associated with a display adapter.

[in] ChildUid

An integer that uniquely identifies the child device. The display miniport driver's DxgkDdiQueryChildRelations function previously provided this identifier to the display port driver.

[out] pBrightnessCaps

Pointer to a DXGK_BRIGHTNESS_CAPS structure that represents the brightness control capabilities of the display panel.

Return value

Return STATUS_SUCCESS if the operation succeeds. Otherwise, return an appropriate NTSTATUS Values error code defined in ntstatus.h.

Remarks

Any device supporting the Brightness3 interface must support transition times, so SmoothBrightness is no longer used.

The NitsBrightness bit has been introduced to represent support for calibrated nit-based brightness. If the device does not support nit-based brightness, brightness levels will still be represented in millinits, but the operating system will be aware that they don’t map to known absolute brightness levels.

Requirements