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


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

Драйвер мини-порта дисплея вызывает 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

См. также раздел

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DXGKCB_SETPOWERCOMPONENTIDLE

DxgkDdiQueryAdapterInfo

DxgkDdiSetPowerComponentFState

DxgkDdiStartDevice