Freigeben über


StorPortPoFxSetComponentResidency-Funktion (storport.h)

Die StorPortPoFxSetComponentResidency-Routine legt die geschätzte Zeit fest, wie lange eine Speichergerätekomponente wahrscheinlich im Leerlauf verbleibt, nachdem die Komponente in den Leerlauf gelangt ist.

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 Host bus adapter (HBA). Dies ist die Geräteerweiterung, die verwendet wird, um das Gerät vor einem Aufruf von StorPortInitializePoFxPower zu registrieren.

[in, optional] Address

Die Adresse einer Speichergeräteeinheit. Dieser Parameter ist NULL , wenn der Wohnsitz einer Speicheradapterkomponente festgelegt wird.

[in] Component

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

[in] Residency

Die geschätzte Aufenthaltszeit in 100 Nanosekundeneinheiten. Dieser Parameter ist ein Hinweis an das Power Management Framework (PoFx) darüber, wie lange die Komponente nach einem Übergang von der aktiven Bedingung zur Leerlaufbedingung wahrscheinlich im Leerlauf verbleibt.

Rückgabewert

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

Rückgabecode Beschreibung
STOR_STATUS_SUCCESS
Die Komponentenresidenz wurde erfolgreich festgelegt.
STOR_STATUS_INVALID_PARAMETER
HwDeviceExtension oder Device ist NULL.

Oder

Address verweist auf eine ungültige Einheitenadressstruktur.

Oder

Das durch Adresse 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
Unterstützte Mindestversion (Client) Verfügbar ab Windows 8.
Zielplattform Universell
Header storport.h
Bibliothek Storport.lib
IRQL <= DISPATCH_LEVEL

Weitere Informationen

PoFxSetComponentResidency