StorPortPoFxActivateComponent-Funktion (storport.h)

Artikel
05/23/2024

Die StorPortPoFxActivateComponent-Routine erhöht die Anzahl der Aktivierungsreferenzen für die angegebene Komponente eines Speichergeräts.

Syntax

ULONG StorPortPoFxActivateComponent(
  [in]           PVOID               HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS       Address,
  [in, optional] PSCSI_REQUEST_BLOCK Srb,
  [in]           ULONG               Component,
  [in]           ULONG               Flags
);

Parameter

[in] HwDeviceExtension

Ein Zeiger auf die Hardwaregeräteerweiterung für den Host Bus Adapter (HBA).

[in, optional] Address

Die Adresse einer Speichergeräteeinheit. Dieser Parameter ist NULL , wenn eine Speicheradapterkomponente aktiviert wird.

[in, optional] Srb

Der SRB, der die Komponentenaktivierung auslöst. Dieser Parameter ist NULL , wenn der Miniport eine Gerätekomponente für eine Anforderung aktiviert, die nicht über Storport gesendet wird.

[in] Component

Der Index, der die Komponente identifiziert. Dieser Parameter ist ein Index in das Array Components in der STOR_POFX_DEVICE Struktur, die der Miniporttreiber für das Gerät mit einem Aufruf von StorPortInitializePoFxPower registriert hat. Wenn das Komponentenarray N-Elemente enthält, reichen die Komponentenindizes von 0 bis N–1.

[in] Flags

Nicht verwendet. Auf 0 festlegen.

Rückgabewert

Die StorPortPoFxActivateComponent-Routine gibt einen der folgenden status Codes zurück:

Rückgabecode	Beschreibung
STOR_STATUS_SUCCESS	Die Referenz zur Speichergeräteaktivierung wurde erfolgreich erhöht, und die Komponente befindet sich im aktiven Zustand.
STOR_STATUS_INVALID_PARAMETER	Entweder HwDeviceExtension oder Device ist NULL. Oder Address verweist auf eine ungültige Einheitenadressstruktur. Oder Das durch Adresse angegebene Speichergerät wurde nicht gefunden. Oder Das Speichergerät ist nicht beim Power Management Framework (PoFx) registriert. Oder Der SRB, auf den von Srb verwiesen wird, wird nicht von Storport gesendet. Oder Der Flags-Parameter ist nonzero.
STOR_STATUS_INVALID_DEVICE_REQUEST	Der Adapter oder die Einheit unterstützt kein PoFx.
STOR_STATUS_INVALID_IRQL	Die aktuelle IRQL-> DISPATCH_LEVEL.
STOR_STATUS_BUSY	Die Referenz zur Speichergeräteaktivierung wurde erfolgreich erhöht, aber die Komponente befindet sich weiterhin im Leerlaufzustand.

Hinweise

Derzeit weisen sowohl Adaptergeräte als auch Einheitengeräte die maximale Komponentenanzahl von 1 auf. Der Index in Component muss immer auf 0 festgelegt werden.

Jeder Aufruf von StorPortPoFxActivateComponent muss mit einem nachfolgenden Aufruf von StorPortPoFxIdleComponent abgeglichen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 8.
Zielplattform	Universell
Header	storport.h
Bibliothek	Storport.lib
IRQL	IRQL <= DISPATCH_LEVEL

Weitere Informationen

STOR_POFX_DEVICE

StorPortInitializePoFxPower

StorPortPoFxIdleComponent

Freigeben über