StorPortPoFxSetComponentLatency, fonction (storport.h)

Article
02/07/2025

La routine StorPortPoFxSetComponentLatency spécifie la latence maximale qui peut être tolérée lors de la transition de la condition inactive à la condition active dans le composant d’appareil de stockage spécifié.

Syntaxe

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

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique matériel pour l’adaptateur de bus hôte (HBA). Il s’agit de l’extension d’appareil utilisée pour inscrire l’appareil dans un appel précédent à StorPortInitializePoFxPower.

[in, optional] Address

Adresse d’une unité d’appareil de stockage. Ce paramètre est NULL lors de la définition de la latence d’un composant d’adaptateur de stockage.

[in] Component

Index qui identifie le composant. Ce paramètre est un index dans le tableau Components dans la structure STOR_POFX_DEVICE que le pilote miniport inscrit pour l’appareil avec un appel à StorPortInitializePoFxPower. Si le tableau Composants contient N éléments, les index de composant sont comprises entre 0 et N-1.

[in] Latency

Temps, en unités de 100 nanosecondes, que le composant d’appareil de stockage peut tolérer une transition d’un état inactif à l’état actif.

Valeur de retour

La routine StorPortPoFxSetComponentLatency retourne l’un des codes d’état suivants :

Retourner le code	Description
STOR_STATUS_SUCCESS	Latence du composant correctement définie.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension ou Device a la valeur NULL. -ou- Adresse pointe vers une structure d’adresse d’unité non valide. -ou- L’appareil de stockage spécifié par adresse est introuvable. -ou- L’index dans Composant spécifie un composant supérieur au nombre de composants pour l’appareil.
STOR_STATUS_INVALID_DEVICE_REQUEST	L’appareil de stockage n’est pas inscrit auprès de l’infrastructure de gestion de l’alimentation (PoFx).
STOR_STATUS_INVALID_IRQL	La > DISPATCH_LEVEL IRQL actuelle.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible à partir de Windows 8.
plateforme cible	Universel
d’en-tête	storport.h
IRQL	<= DISPATCH_LEVEL

Voir aussi

PoFxSetComponentLatency

Partager via