StorPortPoFxActivateComponent-Funktion (storport.h)
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 |
---|---|
|
Der Aktivierungsverweis für Speichergeräte wurde erfolgreich erhöht, und die Komponente befindet sich im aktiven Zustand. |
|
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. |
|
Der Adapter oder die Einheit unterstützt PoFx nicht. |
|
Die aktuelle IRQL-> DISPATCH_LEVEL. |
|
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 |