structure STOR_POFX_DEVICE (storport.h)

Article
02/07/2025

La structure STOR_POFX_DEVICE décrit les attributs d’alimentation d’un appareil de stockage dans l’infrastructure de gestion de l’alimentation (PoFx).

Syntaxe

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;

Membres

Version

Numéro de version de cette structure. Définissez ce membre sur STOR_POFX_DEVICE_VERSION_V1.

Size

Taille de cette structure. Définissez cette valeur sur STOR_POFX_DEVICE_SIZE.

ComponentCount

Nombre d’éléments dans le tableau Components. Définissez ce membre sur 1. Actuellement, un seul composant est pris en charge pour une carte de stockage ou une unité logique.

Flags

Indicateurs de fonctionnalités d’état de l’alimentation de l’appareil. Le miniport définit un ou plusieurs indicateurs d’appareil PoFx pour activer ou désactiver les fonctionnalités d’état d’alimentation.

indicateurs est une combinaison OR au niveau du bit des éléments suivants.

Valeur	Signification
STOR_POFX_DEVICE_FLAG_DISABLE_INTERRUPTS_ON_D3	Spécifie que, lorsqu’il est défini, Storport désactive les interruptions lors du placement de l’adaptateur vers D3 et réactive les interruptions lors de la reprise vers D0.
STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD	Permet à Storport de définir l’état froid D3 de l’adaptateur s’il le prend en charge. Cet indicateur s’applique uniquement aux adaptateurs.
STOR_POFX_DEVICE_FLAG_NO_D0	Demande qu’un IRP d’alimentation ne soit pas envoyé à l’objet de l’appareil pour l’adaptateur ou l’unité.
STOR_POFX_DEVICE_FLAG_NO_D3	Demande qu’un IRP de mise hors tension ne soit pas envoyé à l’objet de l’appareil pour l’adaptateur ou l’unité.
STOR_POFX_DEVICE_FLAG_NO_DUMP_ACTIVE	Le miniport n’est pas en mesure d’activer l’appareil de stockage en mode dump si l’appareil est entré dans l’état inactif ou si l’état d’inactivité est désactivé. Cet indicateur indique si un appareil est disponible pour le vidage lorsqu’il est inactif.

Components[ANYSIZE_ARRAY]

Ce membre est le premier élément d’un tableau d’un ou plusieurs éléments STOR_POFX_COMPONENT. Si le tableau contient plusieurs éléments, les éléments supplémentaires suivent immédiatement la structure STOR_POFX_DEVICE. Le tableau contient un élément pour chaque composant de l’appareil. Actuellement, les appareils de stockage n’ont qu’un seul composant afin que d’autres structures de composants soient inutiles.

Remarques

Pour inscrire une carte de stockage pour la prise en charge de Storport PoFx, le pilote miniport appelle StorPortEnablePassiveInitialization dans sa routine HwStorInitialize et implémente une routine HwStorPassiveInitializeRoutine. Le miniport appelle StorPortInitializePoFxPower dans son HwStorPassiveInitializeRoutine pour fournir des informations sur le composant de l’adaptateur.

Pour inscrire une unité de stockage pour la prise en charge de Storport PoFx, le pilote miniport implémente la routine de rappel HwStorUnitControl et fournit la gestion du code de contrôle d’unité ScsiUnitPoFxPowerInfo. Lorsque la gestion du code de contrôle ScsiUnitPoFxPowerInfo, le miniport appelle StorPortInitializePoFxPower si la gestion de l’alimentation inactive du composant d’unité est activée.

Composant de l’appareil de stockage identifié par son index de tableau Components. Les appareils de stockage n’ont qu’un seul composant afin que l’index de 0 soit utilisé. Les routines telles que StorPortPoFxActivateComponent et StorPortPoFxIdleComponent utiliser l’index de tableau d’un composant pour identifier le composant.

Exigences

Exigence	Valeur
client minimum pris en charge	Prise en charge à partir de Windows 8.
d’en-tête	storport.h

Voir aussi

STOR_POFX_COMPONENT

StorPortInitializePoFxPower

StorPortPoFxActivateComponent

StorPortPoFxIdleComponent

Partager via