StorPortPoFxSetComponentLatency-Funktion (storport.h)

Artikel
02/26/2024

Die StorPortPoFxSetComponentLatency-Routine gibt die maximale Latenz an, die beim Übergang von der Leerlaufbedingung zur aktiven Bedingung in der angegebenen Speichergerätekomponente toleriert werden kann.

Syntax

ULONG StorPortPoFxSetComponentLatency(
  [in]           PVOID         HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS Address,
  [in]           ULONG         Component,
  [in]           ULONGLONG     Latency
);

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 die Latenz 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] Latency

Die Zeit in Einheiten von 100 Nanosekunden, die die Speichergerätekomponente für einen Übergang aus einem Leerlaufzustand in den aktiven Zustand tolerieren kann.

Rückgabewert

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

Rückgabecode	Beschreibung
STOR_STATUS_SUCCESS	Die Komponentenlatenz 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 beim Power Management Framework (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
IRQL	<= DISPATCH_LEVEL

Weitere Informationen

PoFxSetComponentLatency

Freigeben über