Fonction ExCancelTimer (wdm.h)
La routine ExCancelTimer annule un minuteur qui a été défini par un appel précédent à la routine ExSetTimer .
Syntaxe
BOOLEAN ExCancelTimer(
[in, out] PEX_TIMER Timer,
[in, optional] PEXT_CANCEL_PARAMETERS Parameters
);
Paramètres
[in, out] Timer
Pointeur vers une structure EX_TIMER . Cette structure est un objet de minuteur qui a été précédemment alloué par la routine ExAllocateTimer .
[in, optional] Parameters
Les pilotes doivent définir ce paramètre sur NULL.
Valeur retournée
Cette routine retourne TRUE si le minuteur a été annulé. Sinon, la routine retourne FALSE.
Remarques
Une fois que votre pilote a appelé la routine ExSetTimer pour définir le minuteur, le minuteur peut être annulé avant son expiration. Le pilote peut appeler la routine ExCancelTimer pour annuler explicitement un minuteur en attente. En outre, si le pilote appelle la routine ExSetTimer pour définir un nouveau minuteur sur un objet de minuteur avant l’expiration d’un minuteur précédemment défini sur cet objet, cet appel ExSetTimer annule implicitement le minuteur précédent, puis démarre le nouveau minuteur.
Une valeur de retour TRUE indique que le minuteur a été défini lorsque ExCancelTimer a été appelé. Dans ce cas, la routine annule le minuteur. Une valeur de retour FALSE indique que le minuteur n’a pas été défini, ce qui peut signifier que le minuteur n’a jamais été défini, que le minuteur a déjà été annulé ou que le minuteur a déjà expiré.
Lorsqu’un minuteur expire, le système d’exploitation signale l’objet minuteur. En option, un pilote peut fournir une routine de rappel ExTimerCallback appelée à l’expiration du minuteur. Si le pilote fournit cette routine de rappel, il est garanti que cette routine soit appelée si l’objet minuteur est signalé. Si le minuteur est annulé avant son expiration, l’objet du minuteur n’est pas signalé et la routine de rappel n’est pas appelée.
Pour plus d’informations, consultez Routines et EX_TIMER Objects ExXxxTimer.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 8.1. |
| Plateforme cible | Universal |
| En-tête | wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothèque | Ntoskrnl.lib |
| IRQL | <= DISPATCH_LEVEL |