Fonction PoStartDeviceBusy (wdm.h)

La routine PoStartDeviceBusy marque le début d’une période pendant laquelle l’appareil est occupé.

Syntaxe

void PoStartDeviceBusy(
  [in, out] PULONG IdlePointer
);

Paramètres

[in, out] IdlePointer

Pointeur vers un compteur inactif. Il s’agit d’une valeur de pointeur précédemment retournée par la routine PoRegisterDeviceForIdleDetection . Étant donné que PoRegisterDeviceForIdleDetection peut retourner un pointeur NULL , l’appelant doit vérifier que le pointeur est non NULL avant d’appeler PoStartDeviceBusy.

Valeur de retour

None

Remarques

Les routines PoStartDeviceBusy et PoEndDeviceBusy marquent le début et la fin d’une période pendant laquelle un appareil est occupé. Chaque appel à PoStartDeviceBusy doit être suivi d’un appel correspondant à PoEndDeviceBusy.

Pour chaque appareil, le gestionnaire d’alimentation conserve le nombre d’appels PoStartDeviceBusy en cours pour lesquels il n’a pas encore reçu d’appel PoEndDeviceBusy correspondant. Un appel PoStartDeviceBusy incrémente le nombre de personnes occupées d’un. Un appel PoEndDeviceBusy décrémente le nombre de personnes occupées d’un. Un nombre d’occupations différent de zéro désactive le compteur inactif de l’appareil. Une fois que le nombre de personnes occupées atteint zéro, le gestionnaire d’alimentation réinitialise le compteur inactif au délai d’expiration et active le compteur.

Au lieu d’utiliser les routines PoStartDeviceBusy et PoEndDeviceBusy pour réinitialiser le compteur inactif, vous pouvez appeler la routine PoSetDeviceBusyEx (ou la macro PoSetDeviceBusy ). Pour désactiver le compteur inactif pendant une période d’activité prolongée, un pilote peut appeler la routine PoRegisterDeviceForIdleDetection pour désactiver et activer les notifications d’inactivité au début et à la fin de la période occupée. Toutefois, PoStartDeviceBusy et PoEndDeviceBusy sont généralement plus pratiques à utiliser à cet effet, et vous devez envisager d’utiliser ces routines dans le nouveau code que vous écrivez pour Windows 7 et les versions ultérieures de Windows.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows 7.
Plateforme cible Universal
En-tête wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL N’importe quel niveau

Voir aussi

PoEndDeviceBusy

PoRegisterDeviceForIdleDetection

PoSetDeviceBusy