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

Статья
02/29/2024

Подпрограмма 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	Активная ссылка на компонент устройства была уменьшена, но компонент по-прежнему активен.

Требования

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

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

STOR_POFX_DEVICE

StorPortInitializePoFxPower

StorPortPoFxActivateComponent

Share via