Fonction PoQueryWatchdogTime (wdm.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 que le délai d’arrêt de surveillance de l’alimentation suivant soit défini.

Valeur retournée

PoQueryWatchdogTime retourne TRUE si un IRP d’alimentation avec surveillance est actuellement affecté à la pile des appareils. Sinon, il 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 irps 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 délai d’expiration suivant.

Par exemple, un pilote qui subit des retards lors de l’arrêt d’un appareil peut appeler cette routine pour déterminer le temps qu’il reste avant que le pilote ne réponde à 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 la période d’expiration, le gestionnaire d’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 au délai d’expiration suivant.

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 <= DISPATCH_LEVEL

Voir aussi

DEVICE_OBJECT