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

Статья
02/29/2024

Драйвер мини-порта вызывает StorPortInitializePoFxPower для регистрации запоминающего устройства с помощью платформы управления питанием (PoFx).

Синтаксис

ULONG StorPortInitializePoFxPower(
  [in]           PVOID             HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS     Address,
  [in]           PSTOR_POFX_DEVICE Device,
  [in, out]      PBOOLEAN          D3ColdEnabled
);

Параметры

[in] HwDeviceExtension

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

[in, optional] Address

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

[in] Device

Указатель на структуру STOR_POFX_DEVICE_V2 , приведение к указателю на STOR_POFX_DEVICE. Эта структура содержит список компонентов с F-состояниями для запоминающего устройства.

[in, out] D3ColdEnabled

Указатель на значение BOOLEAN , которое будет задано драйвером Storport, чтобы указать, включено ли холодное состояние D3 для запоминающего устройства.

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

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

Код возврата	Описание
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension или Device имеет значение NULL. -или- Адрес указывает на недопустимую структуру адресов единиц. -или- Устройство хранения, указанное в поле Адрес , не найдено. -или- Структура STOR_POFX_DEVICE , на которую указывает устройство, отформатирована неправильно или содержит недопустимые данные.
STOR_STATUS_SUCCESS	Устройство хранения успешно зарегистрировано в PoFx.
STOR_STATUS_INSUFFICIENT_RESOURCES	Недостаточно ресурсов для регистрации устройства хранения в PoFx.
STOR_STATUS_UNSUCCESSFUL	Устройство хранения не было успешно зарегистрировано в PoFx. -или- Устройство хранения уже зарегистрировано в PoFx.

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

Если флаг STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD установлен в элементе Флагиустройства, Storport попытается включить поддержку D3 Cold для компонента устройства. Состояние D3 Cold enabled возвращается в значении BOOLEAN , на которое указывает D3ColdEnabled.

Требования

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

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

STOR_POFX_DEVICE

Share via