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

  • Статья

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

Синтаксис

DXGKCB_SETPOWERCOMPONENTIDLE DxgkcbSetpowercomponentidle;

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

Параметры

[in] hAdapter

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

[in] ComponentIndex

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

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

None

Remarks

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

DXGKCB_XXX функции реализуются Dxgkrnl. Чтобы использовать эту функцию обратного вызова, вызовите DxgkCbSetPowerComponentIdle через DXGKRNL_INTERFACE. Каждый вызов этой функции должен быть связан с вызовом функции DXGKCB_SETPOWERCOMPONENTACTIVE .

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

Эта функция должна вызываться по адресу IRQL <= DISPATCH_LEVEL. Его можно вызвать в irQL = DISPATCH_LEVEL только в том случае, если тип компонента DXGK_POWER_COMPONENT_OTHER.

Требования

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

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

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DXGKCB_SETPOWERCOMPONENTACTIVE

DxgkDdiQueryAdapterInfo

DxgkDdiStartDevice