Fonction PoFxReportDevicePoweredOn (wdm.h)

La routine PoFxReportDevicePoweredOn informe l’infrastructure de gestion de l’alimentation (PoFx) que l’appareil a terminé la transition demandée vers l’état d’alimentation D0 (entièrement activé).

Syntaxe

void PoFxReportDevicePoweredOn(
  [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

Le pilote d’un appareil inscrit doit appeler PoFxReportDevicePoweredOn après l’une des occurrences suivantes :

  • PoFx appelle la routine de rappel DevicePowerRequiredCallback du pilote pour informer le pilote que l’appareil doit entrer dans l’état d’alimentation D0.
  • PoFx appelle la routine de rappel DirectedPowerUpCallback du pilote pour informer le pilote que l’appareil doit entrer dans l’état d’alimentation D0.
  • PoFx envoie au pilote un IRP S0 (une requête IRP_MN_SET_POWER ) pour informer le pilote d’une transition système en attente vers l’état d’alimentation S0.
En réponse à l’une ou l’autre occurrence, le pilote envoie D0 IRP (une demande de IRP_MN_SET_POWER ) dans sa pile d’appareils pour lancer une transition vers l’état d’alimentation D0, si l’appareil n’est pas déjà à l’état D0. Une fois le pilote terminé (et tous les pilotes inférieurs terminés), la transition vers l’état D0, le pilote appelle PoFxReportDevicePoweredOn pour notifier PoFx.

Le pilote doit appeler PoFxReportDevicePoweredOn , qu’aucun IRP D0 n’est requis, que la requête IRP D0 échoue, que l’IRP D0 distribué réussisse ou échoue, ou que l’IRP S0 réussisse ou échoue.

Pour le rappel de mise sous tension nécessaire/dirigé, l’appel PoFxReportDevicePoweredOn peut se produire pendant ou après l’appel de rappel.

Pour une requête IRP S0, le pilote doit effectuer cette demande dès que possible, basculer l’appareil à l’état d’alimentation D0 et appeler PoFxReportDevicePoweredOn. Pour plus d’informations, consultez Gestion d’un système Set-Power IRP dans un propriétaire de stratégie d’alimentation des appareils.

Lors de l’entrée dans PoFxReportDevicePoweredOn, l’appareil peut se trouver dans un état d’alimentation D0 non initialisé dans lequel tous les composants de l’appareil sont activés. En réponse à l’appel PoFxReportDevicePoweredOn , PoFx configure l’appareil dans un état D0 initialisé. Pendant cette configuration, PoFx bascule autant de composants que possible vers des états d’alimentation Fx de faible puissance.

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

Voir aussi

DevicePowerRequiredCallback

IRP_MN_SET_POWER

PoFxRegisterDevice