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

Статья
08/07/2023

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

Синтаксис

ULONG StorPortPoFxActivateComponent(
  [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 , если мини-порт активизирует компонент устройства для запроса, не отправленного через Storport.

[in] Component

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

[in] Flags

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

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

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

Код возврата	Описание
STOR_STATUS_SUCCESS	Ссылка на активацию устройства хранения успешно увеличена, а компонент находится в активном состоянии.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension или Device имеет значение NULL. -или- Адрес указывает на недопустимую структуру адресов единиц. -или- Устройство хранения, указанное в поле Адрес , не найдено. -или- Запоминающее устройство не зарегистрировано в платформе управления питанием (PoFx). -или- SRB, на который указывает Srb , не отправляется из Storport. -или- Параметр Flags не является нулевым.
STOR_STATUS_INVALID_DEVICE_REQUEST	T Адаптер или единица не поддерживают PoFx.
STOR_STATUS_INVALID_IRQL	Текущий > DISPATCH_LEVEL IRQL.
STOR_STATUS_BUSY	Ссылка на активацию устройства хранения успешно увеличена, но компонент по-прежнему находится в состоянии простоя

Требования

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

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

STOR_POFX_DEVICE

StorPortInitializePoFxPower

StorPortPoFxIdleComponent

Share via