StorPortPoFxSetComponentResidency-Funktion (storport.h)

Artikel
02/07/2025

Die StorPortPoFxSetComponentResidency Routine legt die geschätzte Zeit fest, wie lange eine Speichergerätekomponente wahrscheinlich im Leerlauf bleibt, nachdem die Komponente die Leerlaufbedingung eingegeben hat.

Syntax

ULONG StorPortPoFxSetComponentResidency(
  [in]           PVOID         HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS Address,
  [in]           ULONG         Component,
  [in]           ULONGLONG     Residency
);

Parameter

[in] HwDeviceExtension

Ein Zeiger auf die Hardwaregeräteerweiterung für den Hostbusadapter (HBA). Dies ist die Geräteerweiterung, die zum Registrieren des Geräts in einem vorherigen Aufruf von StorPortInitializePoFxPowerverwendet wird.

[in, optional] Address

Die Adresse einer Speichergeräteinheit. Dieser Parameter ist NULL- beim Festlegen der Residency einer Speicheradapterkomponente.

[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] Residency

Die geschätzte Aufenthaltszeit in 100 Nanosekundeneinheiten. Dieser Parameter ist ein Hinweis auf das Power Management Framework (PoFx), wie lange die Komponente wahrscheinlich im Leerlauf bleibt, nachdem ein Übergang von der aktiven Bedingung zur Leerlaufbedingung erfolgt ist.

Rückgabewert

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

Rückgabecode	Beschreibung
STOR_STATUS_SUCCESS	Die Komponenten-Residency wurde erfolgreich festgelegt.
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- Der Index in Component gibt eine Komponente an, die größer als die Komponentenanzahl für das Gerät ist.
STOR_STATUS_INVALID_DEVICE_REQUEST	Das Speichergerät ist nicht bei PoFx registriert.
STOR_STATUS_INVALID_IRQL	Die aktuelle IRQL-> DISPATCH_LEVEL.

Anforderungen

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

Siehe auch

PoFxSetComponentResidency

Freigeben über