функция обратного вызова DXGKCB_SETPOWERCOMPONENTACTIVE (d3dkmddi.h)

Статья
08/07/2023

Драйвер мини-порта дисплея вызывает DXGKCB_SETPOWERCOMPONENTACTIVE для доступа к компоненту питания. После возврата этой функции драйвер мини-порта дисплея может изменить параметры оборудования компонента.

Синтаксис

DXGKCB_SETPOWERCOMPONENTACTIVE DxgkcbSetpowercomponentactive;

void DxgkcbSetpowercomponentactive(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT ComponentIndex
)
{...}

Параметры

[in] hAdapter

Дескриптор для видеоадаптера. Драйвер мини-порта дисплея получает дескриптор от элемента DeviceHandle структуры DXGKRNL_INTERFACE в вызове функции DxgkDdiStartDevice .

[in] ComponentIndex

Индекс компонента питания, заданный DXGKARG_QUERYADAPTERINFO. pInputData в вызове функции DxgkDdiQueryAdapterInfo .

Возвращаемое значение

None

Remarks

Каждый вызов этой функции должен быть связан с вызовом функции DXGKCB_SETPOWERCOMPONENTIDLE , чтобы указать, что оборудование компонента больше не требуется.

При вызове этой функции число активных ссылок компонента увеличивается на 1. Power Management Framework поддерживает количество ссылок и помещает компонент в более низкое F-состояние, только если число ссылок становится нулевым.

При вызове этой функции драйвер мини-порта дисплея может получить вызов функции DxgkDdiSetPowerComponentFState в другом потоке выполнения.

DXGKCB_XXX функции реализуются Dxgkrnl. Чтобы использовать эту функцию обратного вызова, вызовите DxgkCbSetPowerComponentActive через DXGKRNL_INTERFACE.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 (WDDM 1.2)
Минимальная версия сервера	Windows Server 2012
Целевая платформа	Персональный компьютер
Верхняя часть	d3dkmddi.h (включая D3dkmddi.h)
IRQL	PASSIVE_LEVEL