struttura STOR_POFX_DEVICE (storport.h)

Articolo
08/07/2023

La struttura STOR_POFX_DEVICE descrive gli attributi di alimentazione di un dispositivo di archiviazione nel framework di risparmio energia (PoFx).

Sintassi

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;

Members

Version

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

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 è supportato solo un singolo componente per una scheda di archiviazione o un'unità logica.

Flags

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

Flags è una combinazione OR bit per bit della seguente.

Valore	Significato
STOR_POFX_DEVICE_FLAG_DISABLE_INTERRUPTS_ON_D3	Specifica che, se impostato, Storport disabiliterà gli interrupt durante l'inserimento dell'adapter su D3 e riattiva gli interrupt durante la ripresa in D0.
STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD	Consente a Storport di impostare lo stato di freddo D3 per l'adattatore, se supportato. Questo flag si applica solo agli adattatori.
STOR_POFX_DEVICE_FLAG_NO_D0	Richiede che un IRP di alimentazione non venga inviato all'oggetto dispositivo per l'adattatore o l'unità.
STOR_POFX_DEVICE_FLAG_NO_D3	Richiede che un IRP di alimentazione non venga inviato all'oggetto dispositivo per l'adattatore o l'unità.
STOR_POFX_DEVICE_FLAG_NO_DUMP_ACTIVE	Il miniport non è in grado di attivare il dispositivo di archiviazione in modalità dump se il dispositivo ha immesso lo stato di inattività o l'accensione quando lo stato di inattività. Questo flag indica se un dispositivo è disponibile per il dump quando è inattiva.

Components[ANYSIZE_ARRAY]

Questo membro è il primo elemento di 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 nel dispositivo. Attualmente, i dispositivi di archiviazione hanno un solo componente, quindi le strutture aggiuntive dei componenti non sono necessarie.

Commenti

Per registrare un adattatore di archiviazione per il supporto di Storport PoFx, il driver miniport chiama StorPortEnablePassiveInitialization nella routine HwStorInitialize e implementa un 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 il risparmio energia inattiva per il componente unità è abilitato.

Componente per il dispositivo di archiviazione identificato dall'indice della matrice Components . I dispositivi di archiviazione hanno un solo componente, quindi viene usato l'indice 0. Routine come StorPortPoFxActivateComponent e StorPortPoFxIdleComponent usano l'indice di matrice di un componente per identificare il componente.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato a partire da Windows 8.
Intestazione	storport.h

Vedi anche

STOR_POFX_COMPONENT

StorPortInitializePoFxPower

StorPortPoFxActivateComponent

StorPortPoFxIdleComponent

Condividi tramite