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


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

Подпрограмма 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
Адаптер или единица не поддерживают PoFx.
STOR_STATUS_INVALID_IRQL
Текущий > DISPATCH_LEVEL IRQL.
STOR_STATUS_BUSY
Ссылка на активацию устройства хранения успешно увеличена, но компонент по-прежнему находится в состоянии простоя

Комментарии

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

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

Требования

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

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

STOR_POFX_DEVICE

StorPortInitializePoFxPower

StorPortPoFxIdleComponent