структура STOR_POFX_DEVICE (storport.h)

Статья
02/07/2025

Структура STOR_POFX_DEVICE описывает атрибуты питания устройства хранения для платформы управления питанием (PoFx).

Синтаксис

typedef struct _STOR_POFX_DEVICE {
  ULONG               Version;
  ULONG               Size;
  ULONG               ComponentCount;
  ULONG               Flags;
  STOR_POFX_COMPONENT Components[ANYSIZE_ARRAY];
} STOR_POFX_DEVICE, *PSTOR_POFX_DEVICE;

Члены

Version

Номер версии этой структуры. Установите для этого элемента значение STOR_POFX_DEVICE_VERSION_V1.

Size

Размер этой структуры. Задайте для этого значения значение STOR_POFX_DEVICE_SIZE.

ComponentCount

Количество элементов в массиве компонентов . Задайте для этого члена значение 1. В настоящее время для адаптера хранилища или логического блока поддерживается только один компонент.

Flags

Флаги возможностей состояния питания устройства. Минипорт задает один или несколько флагов устройства PoFx для включения или отключения возможностей состояния питания.

Флаги — это побитовое сочетание ИЛИ следующего.

Ценность	Значение
STOR_POFX_DEVICE_FLAG_DISABLE_INTERRUPTS_ON_D3	Указывает, что при установке Storport отключает прерывания при вводе адаптера в D3 и повторно активирует прерывания при возобновлении до D0.
STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD	Позволяет Storport задать холодное состояние D3 для адаптера, если оно поддерживает его. Этот флаг применяется только к адаптерам.
STOR_POFX_DEVICE_FLAG_NO_D0	Запрашивает, что IRP-код питания не отправляется в объект устройства для адаптера или единицы.
STOR_POFX_DEVICE_FLAG_NO_D3	Запрашивает, чтобы IRP не был отправлен в объект устройства для адаптера или единицы.
STOR_POFX_DEVICE_FLAG_NO_DUMP_ACTIVE	Минипорт не может привести устройство хранения к активному в режиме дампа, если устройство ввело состояние простоя или питание при простое состояние. Этот флаг указывает, доступно ли устройство для дампа при простое.

Components[ANYSIZE_ARRAY]

Этот элемент является первым элементом в массиве одного или нескольких элементов STOR_POFX_COMPONENT. Если массив содержит несколько элементов, дополнительные элементы немедленно следуют STOR_POFX_DEVICE структуре. Массив содержит один элемент для каждого компонента устройства. В настоящее время устройства хранения имеют только один компонент, поэтому дополнительные структуры компонентов не нужны.

Замечания

Чтобы зарегистрировать адаптер хранилища для поддержки Storport PoFx, драйвер минипорта вызывает StorPortEnablePassiveInitialization в своей HwStorInitialize и реализует HwStorPassiveInitializeRoutine. Минипорт вызывает StorPortInitializePoFxPower в нем HwStorPassiveInitializeRoutine, чтобы предоставить сведения о компоненте адаптера.

Чтобы зарегистрировать единицу хранения для поддержки Storport PoFx, драйвер минипорта реализует подпрограмму обратного вызова HwStorUnitControl и обеспечивает обработку кода элемента управления ScsiUnitPoFxPowerInfo. При обработке кода элемента управления ScsiUnitPoFxPowerInfo минипорт вызывает StorPortInitializePoFxPower, если включено управление питанием для компонента единицы простоя.

Компонент для устройства хранения, определяемого его компонентом индексом массива. Устройства хранения имеют только один компонент, поэтому используется индекс 0. Подпрограммы, такие как StorPortPoFxActivateComponent и StorPortPoFxIdleComponent использовать индекс массива компонента для идентификации компонента.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается начиная с Windows 8.
заголовка	storport.h

См. также

STOR_POFX_COMPONENT

StorPortInitializePoFxPower

StorPortPoFxActivateComponent

StorPortPoFxIdleComponent

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