Fonction PoFxSetComponentResidency (wdm.h)

Article
02/27/2024

La routine PoFxSetComponentResidency définit la durée estimée pendant laquelle un composant est susceptible de rester inactif une fois que le composant est entré dans la condition d’inactivité.

Syntaxe

void PoFxSetComponentResidency(
  [in] POHANDLE  Handle,
  [in] ULONG     Component,
  [in] ULONGLONG Residency
);

Paramètres

[in] Handle

Handle qui représente l’inscription de l’appareil auprès de l’infrastructure de gestion de l’alimentation (PoFx). Le pilote de périphérique a précédemment reçu ce handle de la routine PoFxRegisterDevice .

[in] Component

Index qui identifie le composant. Ce paramètre est un index dans le tableau Components de la structure PO_FX_DEVICE que le pilote de périphérique a utilisé pour inscrire l’appareil auprès de PoFx. Si le tableau Components contient N éléments, les index de composant 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 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. Pour plus d'informations, consultez la section Notes.

Valeur de retour

None

Remarques

Le pilote appelant fournit une durée de résidence estimée que PoFx peut utiliser comme indicateur pour améliorer les performances. PoFx utilise cet indicateur pour sélectionner un état Fx de faible consommation approprié pour un composant qui est dans l’état d’inactivité.

Le pilote de périphérique peut appeler PoFxSetComponentResidency chaque fois qu’un changement de circonstances nécessite une modification de la durée de résidence estimée. Après chaque appel, la nouvelle durée de résidence estimée reste en vigueur jusqu’à ce que le pilote appelle à nouveau PoFxSetComponentResidency pour le mettre à jour.

Si un composant est dans la condition d’inactivité lorsque PoFxSetComponentResidency est appelé, PoFx peut modifier l’état Fx du composant pour prendre en compte la nouvelle durée de résidence estimée spécifiée par l’appelant.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 8.
Plateforme cible	Universal
En-tête	wdm.h
Bibliothèque	Ntoskrnl.lib
DLL	Ntoskrnl.exe
IRQL	<= DISPATCH_LEVEL

Partager via