Функция PoFxSetComponentResidency (wdm.h)

Статья
08/08/2023

Подпрограмма PoFxSetComponentResidency задает предполагаемое время, в течение некоторого времени, когда компонент, скорее всего, останется в состоянии простоя после того, как компонент перейдет в состояние простоя.

Синтаксис

void PoFxSetComponentResidency(
  [in] POHANDLE  Handle,
  [in] ULONG     Component,
  [in] ULONGLONG Residency
);

Параметры

[in] Handle

Дескриптор, представляющий регистрацию устройства с помощью платформы управления питанием (PoFx). Драйвер устройства ранее получил этот дескриптор из подпрограммы PoFxRegisterDevice .

[in] Component

Индекс, идентифицирующий компонент. Этот параметр представляет собой индекс массива Components в структуре PO_FX_DEVICE , используемой драйвером устройства для регистрации устройства в PoFx. Если массив Components содержит N элементов, индексы компонентов варьируются от 0 до N–1.

[in] Residency

Предполагаемое время расположения в 100-наносекундных единицах. Этот параметр является подсказкой PoFx о том, как долго компонент, скорее всего, останется в состоянии простоя после перехода от активного условия к условию простоя. Дополнительные сведения см. в подразделе "Примечания".

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

None

Remarks

Вызывающий драйвер предоставляет предполагаемое время проживания, которое PoFx может использовать в качестве указания для повышения производительности. PoFx использует это указание для выбора соответствующего состояния Fx с низким энергопотреблением для компонента, который находится в состоянии простоя.

Драйвер устройства может вызывать PoFxSetComponentResidency каждый раз, когда изменение обстоятельств требует изменения предполагаемого времени расположения. После каждого вызова новое предполагаемое время расположения остается в силе до тех пор, пока драйвер снова не вызовет PoFxSetComponentResidency , чтобы обновить его.

Если компонент находится в состоянии простоя при вызове PoFxSetComponentResidency , PoFx может изменить состояние Fx компонента в соответствии с новым предполагаемым временем расположения, заданным вызывающим объектом.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 8.
Целевая платформа	Универсальное
Верхняя часть	wdm.h
Библиотека	Ntoskrnl.lib
DLL	Ntoskrnl.exe
IRQL	<= DISPATCH_LEVEL

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