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


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

Подпрограмма StorPortPoFxIdleComponent уменьшает количество ссылок на активацию указанного компонента запоминающего устройства.

Синтаксис

ULONG StorPortPoFxIdleComponent(
  [in]           PVOID               HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS       Address,
  [in, optional] PSCSI_REQUEST_BLOCK Srb,
  [in]           ULONG               Component,
  [in]           ULONG               Flags
);

Параметры

[in] HwDeviceExtension

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

[in, optional] Address

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

[in, optional] Srb

SRB, запускающий деактивацию компонента. Этот параметр имеет значение NULL , если мини-порт бездействует внутри компонента устройства.

[in] Component

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

[in] Flags

Не используется. Задайте значение 0.

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

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

Код возврата Описание
STOR_STATUS_SUCCESS
Ссылка на активацию устройства хранения была успешно уменьшена, а компонент находится в бездействии.
STOR_STATUS_INVALID_PARAMETER
HwDeviceExtension или Device имеет значение NULL.

-или-

Address указывает на недопустимую структуру адресов единиц.

-или-

Устройство хранения, указанное в поле Адрес , не найдено.

-или-

Запоминающее устройство не зарегистрировано в платформе управления питанием (PoFx).

-или-

SRB, на который указывает Srb , не отправляется из Storport.

-или-

Параметр Flags не является нулевым.

STOR_STATUS_INVALID_DEVICE_REQUEST
Адаптер или блок не поддерживает PoFx.

-или-

StorPortPoFxIdleComponent был вызван с неактивным компонентом и Srb , для которого не был выполнен предыдущий вызов StorPortPoFxActivateComponent .

STOR_STATUS_INVALID_IRQL
Текущий > DISPATCH_LEVEL IRQL.
STOR_STATUS_BUSY
Активная ссылка на компонент устройства была уменьшена, но компонент по-прежнему активен.

Комментарии

В настоящее время как адаптеры, так и устройства единиц имеют максимальное число компонентов 1. Индекс в компоненте всегда должен иметь значение 0.

Каждый вызов StorPortPoFxIdleComponent должен соответствовать предыдущему вызову StorPortPoFxActivateComponent.

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows 8.
Целевая платформа Универсальное
Верхняя часть storport.h
IRQL Любой

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

STOR_POFX_DEVICE

StorPortInitializePoFxPower

StorPortPoFxActivateComponent