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

Статья
02/07/2025

Драйвер минипорта вызывает 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 или устройства имеет значение 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 установлен в элементе FlagsDevice, Storport попытается включить поддержку D3 Cold для компонента устройства. Состояние D3 Cold включено возвращается в значение BOOLEAN, на которое указывает D3ColdEnabled.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows 8.
целевая платформа	Всеобщий
заголовка	storport.h

См. также

STOR_POFX_DEVICE

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