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


функция обратного вызова 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.

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

Никакой

Замечания

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

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

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

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 8 (WDDM 1.2)
минимальный поддерживаемый сервер Windows Server 2012
целевая платформа Настольный
заголовка d3dkmddi.h (include D3dkmddi.h)
IRQL PASSIVE_LEVEL

См. также

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DXGKCB_SETPOWERCOMPONENTIDLE

DxgkDdiQueryAdapterInfo

DxgkDdiSetPowerComponentFState

DxgkDdiStartDevice