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


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

Подпрограмма 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