Функция 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 возвращает один из следующих кодов состояния:
| Код возврата | Описание |
|---|---|
|
Ссылка на активацию устройства хранения успешно увеличена, а компонент находится в активном состоянии. |
|
HwDeviceExtension или Device имеет значение NULL.
-или- Адрес указывает на недопустимую структуру адресов единиц. -или- Устройство хранения, указанное в поле Адрес , не найдено. -или- Запоминающее устройство не зарегистрировано в платформе управления питанием (PoFx). -или- SRB, на который указывает Srb , не отправляется из Storport. -или- Параметр Flags не является нулевым. |
|
Адаптер или единица не поддерживают PoFx. |
|
Текущий > DISPATCH_LEVEL IRQL. |
|
Ссылка на активацию устройства хранения успешно увеличена, но компонент по-прежнему находится в состоянии простоя |
Комментарии
В настоящее время максимальное число компонентов для устройств-адаптеров и устройств единиц составляет 1. Индекс в компоненте всегда должен иметь значение 0.
Каждый вызов StorPortPoFxActivateComponent должен соответствовать последующему вызову StorPortPoFxIdleComponent.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно начиная с Windows 8. |
| Целевая платформа | Универсальное |
| Верхняя часть | storport.h |
| Библиотека | Storport.lib |
| IRQL | IRQL <= DISPATCH_LEVEL |