Fonction StorPortPoFxSetComponentLatency (storport.h)

Article
02/26/2024

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 de périphérique 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é de périphérique de stockage. Ce paramètre a la valeur 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 de la structure STOR_POFX_DEVICE que le pilote miniport a inscrit pour l’appareil avec un appel à StorPortInitializePoFxPower. Si le tableau Composants contient N éléments, les index des composants vont de 0 à N–1.

[in] Latency

Durée, en unités de 100 nanosecondes, que le composant de périphérique de stockage peut tolérer pour une transition entre un état inactif et l’état actif.

Valeur retournée

La routine StorPortPoFxSetComponentLatency retourne l’un des codes status suivants :

Code de retour	Description
STOR_STATUS_SUCCESS	Latence du composant correctement définie.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension ou Device a la valeur NULL. -ou- L’adresse pointe vers une structure d’adresse d’unité non valide. -ou- Le périphérique 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	Le périphérique de stockage n’est pas inscrit auprès de l’infrastructure de gestion de l’alimentation (PoFx).
STOR_STATUS_INVALID_IRQL	Le > DISPATCH_LEVEL IRQL actuel.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 8.
Plateforme cible	Universal
En-tête	storport.h
IRQL	<= DISPATCH_LEVEL

Voir aussi

PoFxSetComponentLatency

Partager via