Fonction PoFxStartDevicePowerManagement (wdm.h)
La routine PoFxStartDevicePowerManagement termine l’inscription d’un appareil avec l’infrastructure de gestion de l’alimentation (PoFx) et démarre la gestion de l’alimentation des appareils.
Syntaxe
void PoFxStartDevicePowerManagement(
[in] POHANDLE Handle
);
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 déjà reçu ce handle de la routine PoFxRegisterDevice .
Valeur de retour
None
Remarques
Une fois qu’un pilote a appelé la routine PoFxRegisterDevice pour inscrire un appareil auprès de PoFx, tous les composants de l’appareil sont entièrement activés et dans l’état actif afin que le pilote puisse terminer l’initialisation du matériel. Pour démarrer la gestion de l’alimentation active, le pilote doit appeler PoFxStartDevicePowerManagement. Par défaut, cet appel bascule tous les composants vers la condition d’inactivité.
Une fois que PoFxStartDevicePowerManagement bascule un composant vers la condition inactive, PoFx peut immédiatement commencer à appeler les routines de rappel du pilote, même avant que PoFxStartDevicePowerManagement ne retourne. PoFx appelle la routine de rappel ComponentIdleConditionCallback du pilote pour indiquer qu’un composant est passé à la condition d’inactivité. Le pilote ne doit pas accéder à un composant qui est en état d’inactivité. Avant que le pilote puisse accéder au composant, il doit appeler poFxActivateComponent et attendre que PoFx appelle la routine de rappel ComponentActiveConditionCallback du pilote. Ce rappel informe le pilote que le composant est en état actif et qu’il est accessible en toute sécurité.
Si le pilote nécessite qu’un composant soit en état actif immédiatement après le démarrage de la gestion de l’alimentation, il doit activer explicitement le composant en appelant la routine PoFxActivateComponent , et cet appel doit se produire après l’appel PoFxRegisterDevice , mais avant l’appel PoFxStartDevicePowerManagement .
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 | PASSIVE_LEVEL |
Voir aussi
ComponentActiveConditionCallback