Функция StorPortPoFxSetComponentResidency (storport.h)

Статья
08/07/2023

Подпрограмма StorPortPoFxSetComponentResidency задает предполагаемое время, на которое компонент запоминающее устройство, скорее всего, будет оставаться в состоянии простоя после того, как компонент перейдет в состояние простоя.

Синтаксис

ULONG StorPortPoFxSetComponentResidency(
  [in]           PVOID         HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS Address,
  [in]           ULONG         Component,
  [in]           ULONGLONG     Residency
);

Параметры

[in] HwDeviceExtension

Указатель на расширение аппаратного устройства для адаптера шины узла (HBA). Это расширение устройства, используемое для регистрации устройства в предыдущем вызове StorPortInitializePoFxPower.

[in, optional] Address

Адрес единицы хранения. Этот параметр имеет значение NULL при настройке расположения компонента адаптера хранилища.

[in] Component

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

[in] Residency

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

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

Подпрограмма StorPortPoFxSetComponentResidency возвращает один из следующих кодов состояния:

Код возврата	Описание
STOR_STATUS_SUCCESS	Расположение компонента успешно задано.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension или Device имеет значение NULL. -или- Address указывает на недопустимую структуру адресов единиц. -или- Устройство хранения, указанное в поле Адрес , не найдено. -или- Индекс в компоненте указывает компонент, превышающий число компонентов для устройства.
STOR_STATUS_INVALID_DEVICE_REQUEST	Запоминающее устройство не зарегистрировано в PoFx.
STOR_STATUS_INVALID_IRQL	Текущий > DISPATCH_LEVEL IRQL.

Требования

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

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

PoFxSetComponentResidency

Share via