структура DXGK_BRIGHTNESS_CAPS (d3dkmdt.h)

Статья
02/06/2025

Определяет возможности управления яркостью встроенной панели отображения, которую предоставляет драйвер мини-порта дисплея через вызов функции DxgkDdiGetBrightnessCaps. Используется моделью драйвера windows (WDDM) 1.2 и более поздними версиями.

Синтаксис

typedef struct _DXGK_BRIGHTNESS_CAPS {
  union {
    struct {
      UINT SmoothBrightness : 1;
      UINT AdaptiveBrightness : 1;
      UINT NitsBrightness : 1;
      UINT Reserved : 29;
    };
    [in] UINT Value;
  };
} DXGK_BRIGHTNESS_CAPS;

Члены

[in] SmoothBrightness

Если задано, встроенная панель отображения поддерживает плавное управление яркостью.

Установка этого элемента эквивалентна настройке первого бита 32-разрядного значения (0x00000001).

[in] AdaptiveBrightness

Если задано, встроенная панель отображения поддерживает адаптивный элемент управления яркостью.

Установка этого элемента эквивалентна настройке второго бита 32-разрядного значения (0x00000002).

[in] NitsBrightness

Поддержка яркости на основе Nit. Если установлен NitsBrightness, то яркость дисплея оценивается в соответствии с абсолютными уровнями яркости, измеряемыми в нитах. Данные, предоставляемые драйвером отображения изготовителями оборудования, должны приниматься в процентах от 100 пикселей (OPR) в размере 100% где каждый пиксель имеет значение RGB (255, 255, 255, 255) или эквивалент с плавающей запятой.

Если NitsBrightness не задано, ОС интерпретирует все значения, определенные в нитах/миллинитах, например DXGK_BRIGHTNESS_NIT_RANGE, как немасштабируемые тысячные числа процентов максимального уровня яркости.

[in] Reserved

Этот элемент зарезервирован и должен иметь значение нулю. Установка этого элемента эквивалентна настройке оставшихся 30 битов (0xFFFFFFFC) 32-разрядного значения на нули.

[in] Value

Член объединения, который DXGK_BRIGHTNESS_CAPS содержит одно 32-разрядное значение, определяющее сведения о возможностях управления яркостью драйвера минипорта дисплея.

Замечания

Не предполагайте, что SmoothBrightness членов DXGK_BRIGHTNESS_STATE и DXGK_BRIGHTNESS_CAPS одинаковы. DXGK_BRIGHTNESS_STATE.SmoothBrightness используется для обеспечения плавного управления яркостью на интегрированной панели дисплея. DXGK_BRIGHTNESS_CAPS.SmoothBrightness используется для запроса возможностей управления плавностью яркости интегрированной панели отображения.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8
минимальный поддерживаемый сервер	Windows Server 2012
заголовка	d3dkmdt.h

См. также

DXGK_BRIGHTNESS_STATE

DxgkDdiGetBrightnessCaps

Поделиться через