estructura de STOR_POFX_DEVICE (storport.h)

Artículo
08/07/2023

La estructura STOR_POFX_DEVICE describe los atributos de energía de un dispositivo de almacenamiento en el marco de administración de energía (PoFx).

Sintaxis

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;

Miembros

Version

Número de versión de esta estructura. Establezca este miembro en STOR_POFX_DEVICE_VERSION_V1.

Size

Tamaño de esta estructura. Establezca este valor en STOR_POFX_DEVICE_SIZE.

ComponentCount

Número de elementos de la matriz Components . Establezca este miembro en 1. Actualmente, solo se admite un único componente para un adaptador de almacenamiento o una unidad lógica.

Flags

Marcas de funcionalidades de estado de energía del dispositivo. La minipuerto establece una o varias marcas de dispositivo PoFx para habilitar o deshabilitar las funcionalidades de estado de energía.

Las marcas son una combinación OR bit a bit de lo siguiente.

Valor	Significado
STOR_POFX_DEVICE_FLAG_DISABLE_INTERRUPTS_ON_D3	Especifica que, cuando se establece, Storport deshabilitará las interrupciones al colocar el adaptador en D3 y reactivará las interrupciones al reanudarse en D0.
STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD	Permite a Storport establecer el estado D3 Cold para el adaptador si lo admite. Esta marca solo se aplica a los adaptadores.
STOR_POFX_DEVICE_FLAG_NO_D0	Solicita que un IRP de encendido no se envíe al objeto de dispositivo para el adaptador o la unidad.
STOR_POFX_DEVICE_FLAG_NO_D3	Solicita que un IRP de apagado no se envíe al objeto de dispositivo para el adaptador o la unidad.
STOR_POFX_DEVICE_FLAG_NO_DUMP_ACTIVE	El minipuerto no puede activar el dispositivo de almacenamiento en modo de volcado de memoria si el dispositivo ha entrado en el estado de inactividad o la apagado cuando el estado de inactividad. Esta marca indica si un dispositivo está disponible para volcado cuando está inactivo.

Components[ANYSIZE_ARRAY]

Este miembro es el primer elemento de una matriz de uno o varios elementos STOR_POFX_COMPONENT . Si la matriz contiene más de un elemento, los elementos adicionales siguen inmediatamente la estructura STOR_POFX_DEVICE . La matriz contiene un elemento para cada componente del dispositivo. Actualmente, los dispositivos de almacenamiento solo tienen un componente, por lo que no son necesarias estructuras de componentes adicionales.

Comentarios

Para registrar un adaptador de almacenamiento para la compatibilidad con Storport PoFx, el controlador de miniport llama a StorPortEnablePassiveInitialization en su rutina HwStorInitialize e implementa un HwStorPassiveInitializeRoutine. El miniport llama a StorPortInitializePoFxPower dentro de HwStorPassiveInitializeRoutine para proporcionar información sobre el componente del adaptador.

Para registrar una unidad de almacenamiento para la compatibilidad con Storport PoFx, el controlador de miniport implementa la rutina de devolución de llamada HwStorUnitControl y proporciona el control del código de control de unidad ScsiUnitPoFxPowerInfo . Al controlar el código de control ScsiUnitPoFxPowerInfo , la miniporta llama a StorPortInitializePoFxPower si está habilitada la administración de energía inactiva para el componente de unidad.

Componente del dispositivo de almacenamiento identificado por su índice de matriz Components . Los dispositivos de almacenamiento solo tienen un componente para que se use el índice de 0. Rutinas como StorPortPoFxActivateComponent y StorPortPoFxIdleComponent usan el índice de matriz de un componente para identificar el componente.