StorPortPoFxSetComponentResidency, fonction (storport.h)

Article
02/07/2025

L'StorPortPoFxSetComponentResidency routine définit l’heure estimée pendant laquelle un composant d’appareil de stockage est susceptible de rester inactif une fois que le composant entre dans la condition d’inactivité.

Syntaxe

ULONG StorPortPoFxSetComponentResidency(
  [in]           PVOID         HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS Address,
  [in]           ULONG         Component,
  [in]           ULONGLONG     Residency
);

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 résidence 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] Residency

Durée de résidence estimée, en unités de 100 nanosecondes. Ce paramètre est un indicateur de l’infrastructure de gestion de l’alimentation (PoFx) sur la durée pendant laquelle le composant est susceptible de rester inactif après une transition de la condition active à la condition inactive.

Valeur de retour

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

Retourner le code	Description
STOR_STATUS_SUCCESS	La résidence des composants est 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 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
bibliothèque	Storport.lib
IRQL	<= DISPATCH_LEVEL

Voir aussi

PoFxSetComponentResidency

Partager via