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

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

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

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

Требования

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

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DxgkDdiQueryAdapterInfo

DxgkDdiStartDevice