STOR_POFX_DEVICE Struktur (storport.h)

Die STOR_POFX_DEVICE Struktur beschreibt die Energieattribute eines Speichergeräts zum Power Management Framework (PoFx).

Syntax

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;

Angehörige

Version

Die Versionsnummer dieser Struktur. Legen Sie dieses Element auf STOR_POFX_DEVICE_VERSION_V1fest.

Size

Die Größe dieser Struktur. Legen Sie diesen Wert auf STOR_POFX_DEVICE_SIZEfest.

ComponentCount

Die Anzahl der Elemente im Components Array. Legen Sie dieses Element auf 1 fest. Derzeit wird nur eine einzelne Komponente für einen Speicheradapter oder eine logische Einheit unterstützt.

Flags

Die Geräteleistungsstatusfunktionen kennzeichnen. Der Miniport legt mindestens ein PoFx-Geräteflaggen fest, um Power State-Funktionen zu aktivieren oder zu deaktivieren.

Flags ist eine bitweise OR-Kombination aus folgendem.

Wert	Bedeutung
STOR_POFX_DEVICE_FLAG_DISABLE_INTERRUPTS_ON_D3	Gibt an, dass Storport bei Festlegung Unterbrechungen deaktiviert, wenn der Adapter auf D3 gesetzt wird und unterbrechungsaktiviert wird, wenn die Fortsetzung auf D0 fortgesetzt wird.
STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD	Ermöglicht Storport das Festlegen des D3-Kaltzustands für den Adapter, wenn er ihn unterstützt. Dieses Kennzeichen gilt nur für Adapter.
STOR_POFX_DEVICE_FLAG_NO_D0	Fordert an, dass ein Einschalt-IRP nicht an das Geräteobjekt für den Adapter oder die Einheit gesendet wird.
STOR_POFX_DEVICE_FLAG_NO_D3	Fordert an, dass ein Stromabschalt-IRP nicht an das Geräteobjekt für den Adapter oder die Einheit gesendet wird.
STOR_POFX_DEVICE_FLAG_NO_DUMP_ACTIVE	Der Miniport kann das Speichergerät nicht im Speicherabbildmodus aktivieren, wenn das Gerät den Leerlaufzustand oder den Strom aus dem Leerlaufzustand eingegeben hat. Dieses Kennzeichen gibt an, ob ein Gerät für das Dump verfügbar ist, wenn es sich im Leerlauf befindet.

Components[ANYSIZE_ARRAY]

Dieses Element ist das erste Element in einem Array eines oder mehrerer STOR_POFX_COMPONENT Elemente. Wenn das Array mehrere Elemente enthält, folgen die zusätzlichen Elemente unmittelbar der STOR_POFX_DEVICE Struktur. Das Array enthält ein Element für jede Komponente auf dem Gerät. Derzeit verfügen Speichergeräte nur über eine Komponente, sodass zusätzliche Komponentenstrukturen unnötig sind.

Bemerkungen

Um einen Speicheradapter für die Storport PoFx-Unterstützung zu registrieren, ruft der Miniporttreiber StorPortEnablePassiveInitialization in seiner HwStorInitialize Routine auf und implementiert eine HwStorPassiveInitializeRoutine. Der Miniport ruft StorPortInitializePoFxPower darin HwStorPassiveInitializeRoutine auf, um Informationen zur Adapterkomponente bereitzustellen.

Um eine Speichereinheit für storport PoFx-Unterstützung zu registrieren, implementiert der Miniporttreiber die HwStorUnitControl- Rückrufroutine und stellt die Behandlung der ScsiUnitPoFxPowerInfo Komponentensteuerungscode bereit. Beim Behandeln des ScsiUnitPoFxPowerInfo Steuercode ruft der Miniport StorPortInitializePoFxPower auf, wenn die Energieverwaltung für die Komponentenkomponente im Leerlauf aktiviert ist.

Die Komponente für das Speichergerät, das durch seine Components Arrayindex identifiziert wird. Speichergeräte verfügen nur über eine Komponente, sodass der Index von 0 verwendet wird. Routinen wie StorPortPoFxActivateComponent und StorPortPoFxIdleComponent verwenden den Arrayindex einer Komponente, um die Komponente zu identifizieren.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Wird ab Windows 8 unterstützt.
Header-	storport.h

Siehe auch

STOR_POFX_COMPONENT

StorPortInitializePoFxPower

StorPortPoFxActivateComponent

StorPortPoFxIdleComponent-