Fonction PoQueryWatchdogTime (ntifs.h)

  • Article

La routine PoQueryWatchdogTime indique si le gestionnaire d’alimentation a activé un compteur de délai d’attente de surveillance pour toute IRP d’alimentation actuellement affectée à la pile d’appareils.

Syntaxe

BOOLEAN PoQueryWatchdogTime(
  [in]  PDEVICE_OBJECT Pdo,
  [out] PULONG         SecondsRemaining
);

Paramètres

[in] Pdo

Pointeur vers un objet d’appareil physique (PDO). Ce paramètre pointe vers une structure DEVICE_OBJECT qui représente un appareil physique.

[out] SecondsRemaining

Pointeur vers un emplacement dans lequel la routine écrit l’heure, en secondes, qui reste avant le prochain délai d’attente de surveillance de l’alimentation.

Valeur retournée

PoQueryWatchdogTime retourne TRUE si un IRP d’alimentation avec surveillance est actuellement affecté à la pile des appareils. Sinon, elle retourne FALSE.

Remarques

Cette routine permet aux pilotes en mode noyau de surveiller les compteurs de délai d’attente que le gestionnaire d’alimentation a activés pour suivre les IRP d’alimentation qu’il a émis. Si un ou plusieurs compteurs de délai d’attente de surveillance sont actuellement activés, la routine retourne TRUE et fournit la durée restante avant le prochain délai d’attente.

Par exemple, un pilote qui subit des retards lors de l’arrêt d’un appareil peut appeler cette routine pour déterminer combien de temps il reste avant que le pilote doit répondre à une IRP d’alimentation pour empêcher un arrêt contrôlé (un bogue case activée) du système d’exploitation.

Le gestionnaire d’alimentation définit un compteur de délai d’attente de surveillance lorsqu’il émet un IRP d’alimentation sur la pile de l’appareil. Le délai d’expiration de ce compteur est généralement de plusieurs minutes. Si un appareil de la pile ne répond pas et provoque le blocage de l’IRP pendant le délai d’attente, le gestionnaire de l’alimentation traite cette condition comme une erreur irrécupérable et lance un arrêt contrôlé du système d’exploitation.

Si plusieurs délai d’attente de surveillance de l’alimentation sont actuellement activés, la routine définit *SecondsRemaining sur l’heure restante jusqu’au délai d’attente suivant.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7
Plateforme cible Universal
En-tête ntifs.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

Voir aussi

DEVICE_OBJECT