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 |
---|---|
|
Die Komponentenresidenz wurde erfolgreich festgelegt. |
|
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. |
|
Das Speichergerät ist nicht bei PoFx registriert. |
|
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 |