StorPortPoFxActivateComponent-Funktion (storport.h)

Artikel
02/07/2025

Die StorPortPoFxActivateComponent Routine erhöht die Aktivierungsreferenzanzahl 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 Hostbusadapter (HBA).

[in, optional] Address

Die Adresse einer Speichergeräteinheit. Dieser Parameter ist NULL- beim Aktivieren einer Speicheradapterkomponente.

[in, optional] Srb

Der SRB löst die Komponentenaktivierung aus. 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 im Components Array in der STOR_POFX_DEVICE Struktur, den der Miniporttreiber für das Gerät mit einem Aufruf von StorPortInitializePoFxPowerregistriert hat. Wenn das Components Array N-Elemente enthält, reichen Komponentenindizes von 0 bis N-1.

[in] Flags

Wird nicht verwendet. Auf 0 festgelegt.

Rückgabewert

Die StorPortPoFxActivateComponent Routine gibt einen der folgenden Statuscodes zurück:

Rückgabecode	Beschreibung
STOR_STATUS_SUCCESS	Der Aktivierungsverweis für Speichergeräte 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 Einheitenadressenstruktur. -oder- Das durch Address angegebene Speichergerät wurde nicht gefunden. -oder- Das Speichergerät ist nicht beim Power Management Framework (PoFx) registriert. -oder- Der SRB, auf den Srb verweist, wird nicht von Storport gesendet. -oder- Der parameter Flags ist nonzero.
STOR_STATUS_INVALID_DEVICE_REQUEST	Der Adapter oder die Einheit unterstützt PoFx nicht.
STOR_STATUS_INVALID_IRQL	Die aktuelle IRQL-> DISPATCH_LEVEL.
STOR_STATUS_BUSY	Der Aktivierungsverweis für Speichergeräte wurde erfolgreich erhöht, die Komponente befindet sich jedoch weiterhin im Leerlaufzustand.

Bemerkungen

Derzeit verfügen sowohl Adaptergeräte als auch Gerätegeräte über die maximale Komponentenanzahl von 1. Der Index in Komponenten- muss immer auf 0 festgelegt sein.

Jeder Aufruf von StorPortPoFxActivateComponent muss mit einem nachfolgenden Aufruf von StorPortPoFxIdleComponentabgeglichen werden.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Ab Windows 8 verfügbar.
Zielplattform-	Universal
Header-	storport.h
Library	Storport.lib
IRQL-	IRQL-<= DISPATCH_LEVEL

Siehe auch

STOR_POFX_DEVICE

StorPortInitializePoFxPower

StorPortPoFxIdleComponent-

Freigeben über