STOR_POFX_DEVICE_V2 struttura (storport.h)

Articolo
02/29/2024

La struttura STOR_POFX_DEVICE_V2 descrive gli attributi di alimentazione di un dispositivo di archiviazione nel framework di gestione energia (PoFx). Questa struttura è simile a STOR_POFX_DEVICE ma contiene impostazioni di timeout aggiuntive.

Sintassi

typedef struct _STOR_POFX_DEVICE_V2 {
  ULONG               Version;
  ULONG               Size;
  ULONG               ComponentCount;
  ULONG               Flags;
  union {
    ULONG UnitMinIdleTimeoutInMS;
    ULONG AdapterIdleTimeoutInMS;
  };
  STOR_POFX_COMPONENT Components[ANYSIZE_ARRAY];
} STOR_POFX_DEVICE_V2, *PSTOR_POFX_DEVICE_V2;

Members

Version

Numero di versione di questa struttura. Impostare questo membro su STOR_POFX_DEVICE_VERSION_V2.

Size

Dimensione della struttura. Impostare questo valore su STOR_POFX_DEVICE_SIZE.

ComponentCount

Numero di elementi nella matrice Components . Impostare questo membro su 1. Attualmente, solo un singolo componente è supportato per una scheda di archiviazione o un'unità logica.

Flags

Flag delle funzionalità dello stato dell'alimentazione del dispositivo. Il miniport imposta uno o più flag di dispositivo PoFx per abilitare o disabilitare le funzionalità dello stato di alimentazione.

I flag sono una combinazione OR bit per bit del seguente.

Valore	Significato
STOR_POFX_DEVICE_FLAG_NO_D0	Richiede che un'IRP di alimentazione non venga inviata all'oggetto dispositivo per l'adattatore o l'unità.
STOR_POFX_DEVICE_FLAG_NO_D3	Richiede che un'IRP di alimentazione non venga inviata all'oggetto dispositivo per l'adattatore o l'unità.
STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD	Consente a Storport di impostare lo stato A freddo D3 per l'adattatore se lo supporta. Questo flag si applica solo agli adattatori.
STOR_POFX_DEVICE_FLAG_NO_DUMP_ACTIVE	Il miniport non è in grado di portare il dispositivo di archiviazione attivo in modalità dump se il dispositivo ha immesso lo stato di inattività o la disattivazione quando lo stato inattiva. Questo flag indica se un dispositivo è disponibile per il dump quando è inattiva.
STOR_POFX_DEVICE_FLAG_IDLE_TIMEOUT	Il valore di timeout in UnitMinIdleTimeoutInMS o AdapterIdleTimeoutInMS viene usato per il timeout di inattività D3.

UnitMinIdleTimeoutInMS

Tempo di inattività minimo in millisecondi per un'unità. Questo valore è valido solo quando STOR_POFX_DEVICE_FLAG_IDLE_TIMEOUT è impostato in Flag.

AdapterIdleTimeoutInMS

Valore timeout inattiva dell'adapter in millisecondi. Questo valore è valido solo quando STOR_POFX_DEVICE_FLAG_IDLE_TIMEOUT è impostato in Flag.

Components[ANYSIZE_ARRAY]

Questo membro è il primo elemento in una matrice di uno o più elementi STOR_POFX_COMPONENT . Se la matrice contiene più elementi, gli elementi aggiuntivi seguono immediatamente la struttura STOR_POFX_DEVICE . La matrice contiene un elemento per ogni componente del dispositivo. Attualmente, i dispositivi di archiviazione hanno solo un componente in modo che le strutture aggiuntive dei componenti non siano necessarie.

Commenti

Per registrare un adattatore di archiviazione per il supporto di Storport PoFx, il driver miniport chiama StorPortEnablePassiveInitialization nella routine HwStorInitialize e implementa una routine HwStorPassiveInitializeRoutine. Il miniport chiama StorPortInitializePoFxPower all'interno di HwStorPassiveInitializeRoutine per fornire informazioni sul componente dell'adattatore.

Per registrare un'unità di archiviazione per il supporto di Storport PoFx, il driver miniport implementa la routine di callback HwStorUnitControl e fornisce la gestione del codice di controllo unità SCSIUnitPoFxPowerInfo . Quando si gestisce il codice di controllo SCSIUnitPoFxPowerInfo , il miniport chiama StorPortInitializePoFxPower se è abilitato il risparmio energia inattiva per il componente unità.

Componente per il dispositivo di archiviazione identificato dall'indice matrice Components . I dispositivi di archiviazione hanno solo un componente in modo che venga usato l'indice 0. Routine come StorPortPoFxActivateComponent e StorPortPoFxIdleComponent usano l'indice di matrice di un componente per identificare il componente.