Fonction StorPortPoFxSetComponentResidency (storport.h)

Article
03/05/2024

La routine StorPortPoFxSetComponentResidency définit la durée estimée pendant laquelle un composant de périphérique de stockage est susceptible de rester inactif une fois que le composant est entré 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é de périphérique de stockage. Ce paramètre a la valeur 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 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] Residency

Durée de résidence estimée, en unités de 100 nanosecondes. Ce paramètre est un indicateur pour 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 retournée

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

Code de retour	Description
STOR_STATUS_SUCCESS	La résidence du composant est 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 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
Bibliothèque	Storport.lib
IRQL	<= DISPATCH_LEVEL

Voir aussi

PoFxSetComponentResidency

Partager via