StorPortPoFxSetComponentLatency-Funktion (storport.h)

Artikel
02/07/2025

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

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

Rückgabewert

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

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

Siehe auch

PoFxSetComponentLatency

Freigeben über