StorPortPoFxIdleComponent-Funktion (storport.h)

Artikel
02/07/2025

Die StorPortPoFxIdleComponent Routine erhöht die Aktivierungsreferenzanzahl einer angegebenen Komponente eines Speichergeräts.

Syntax

ULONG StorPortPoFxIdleComponent(
  [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 Leerlauf einer Speicheradapterkomponente.

[in, optional] Srb

Der SRB löst die Deaktivierung der Komponente aus. Dieser Parameter ist NULL-, wenn der Miniport intern eine Gerätekomponente leert.

[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 StorPortPoFxIdleComponent Routine gibt einen der folgenden Statuscodes zurück:

Rückgabecode	Beschreibung
STOR_STATUS_SUCCESS	Der Aktivierungsverweis für Speichergeräte wurde erfolgreich verringert, und die Komponente ist im Leerlauf.
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. -oder- StorPortPoFxIdleComponent wurde mit einer inaktiven Component und einem Srb- aufgerufen, für den ein vorheriger Aufruf von StorPortPoFxActivateComponent nicht ausgeführt wurde.
STOR_STATUS_INVALID_IRQL	Die aktuelle IRQL-> DISPATCH_LEVEL.
STOR_STATUS_BUSY	Der aktive Verweis für die Gerätekomponente wurde dekrementiert, die Komponente ist jedoch noch aktiv.

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 StorPortPoFxIdleComponent muss mit einem vorherigen Aufruf von StorPortPoFxActivateComponentabgeglichen werden.