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

Драйвер мини-порта в режиме ядра вызывает DXGKCB_SETPOWERCOMPONENTRESIDENCY , чтобы задать ожидаемое место расположения для компонента питания типа DXGK_POWER_COMPONENT_OTHER.

Синтаксис

DXGKCB_SETPOWERCOMPONENTRESIDENCY DxgkcbSetpowercomponentresidency;

void DxgkcbSetpowercomponentresidency(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT ComponentIndex,
  [in] ULONGLONG Residency
)
{...}

Параметры

[in] hAdapter

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

[in] ComponentIndex

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

[in] Residency

Ожидаемое место расположения ( максимальное время в единицах 100 наносекунд), которое драйвер мини-порта дисплея ожидает, что компонент питания останется в состоянии простоя после того, как он перейдет в состояние простоя. Power Management Framework использует эти сведения для выбора соответствующего состояния простоя для компонента, который не нарушает запрошенное место расположения. Ожидаемое место расположения, указанное в параметре Residency , остается в силе до тех пор, пока драйвер снова не вызовет эту функцию, чтобы обновить ее. См. заметки.

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

None

Remarks

Примечание

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

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

Если компонент питания находится в состоянии простоя при вызове этой функции, платформа управления питанием может изменить F-состояние компонента в соответствии с ожидаемым значением расположения, указанным в параметре Residency.

Если драйвер задает для параметра Residency значение PO_FX_UNKNOWN_TIME (определенное в Wdm.h), подключаемый модуль Power Engine (PEP) может не задать для компонента F-состояние ниже F0.

Требования

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

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

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DxgkDdiQueryAdapterInfo

DxgkDdiStartDevice