ExDeleteTimer, fonction (wdm.h)
La routine ExDeleteTimer supprime un objet minuteur précédemment alloué par la routine ExAllocateTimer.
Syntaxe
BOOLEAN ExDeleteTimer(
[in] PEX_TIMER Timer,
[in] BOOLEAN Cancel,
[in] BOOLEAN Wait,
[in] PEXT_DELETE_PARAMETERS Parameters
);
Paramètres
[in] Timer
Pointeur vers une structure EX_TIMER. Cette structure est un objet minuteur qui a été précédemment alloué par la routine ExAllocateTimer.
[in] Cancel
Indique s’il faut annuler le minuteur s’il est actuellement défini. Si TRUE, la routine annule le minuteur si le minuteur est défini. Si FALSE, la routine n’annule pas le minuteur s’il est défini. Si l’appelant définit d’attente sur TRUE, Annuler doit également être TRUE; sinon, une vérification des bogues se produit.
[in] Wait
Indique s’il faut attendre que le minuteur termine son expiration si le minuteur a déjà démarré le processus d’expiration. Si TRUE, la routine attend que le minuteur expire. Si FAUX, la routine n’attend pas. Pour plus d’informations, consultez Remarques.
[in] Parameters
Pointeur vers une structure EXT_DELETE_PARAMETERS. Le pilote appelant a précédemment appelé la routine ExInitializeDeleteTimerParameters routine pour initialiser cette structure.
Valeur de retour
Cette routine retourne TRUE si Annuler est TRUE et que le minuteur a été annulé. Sinon, la routine retourne FALSE. Pour plus d’informations, consultez Remarques.
Remarques
Une fois que votre pilote appelle cette routine, l’objet minuteur pointé par minuteur peut ne plus être valide. Toutefois, la valeur du paramètre timer passée à une routine de rappel ExTimerCallback, si le pilote implémente cette routine, est toujours un pointeur valide vers un objet minuteur.
Si Annuler est TRUE, une valeur de retour de FALSE indique que le minuteur n’a jamais été défini ou que le minuteur a été défini, mais a expiré avant d’être annulé. Si Annuler est FALSE, la routine retourne toujours FALSE.
Cette routine peut bloquer si 'attente est TRUE. Si ExDeleteTimer est appelé à partir de la routine ExTimerCallback du pilote, appelée à DISPATCH_LEVEL, le paramètre Wait de cet appel doit être FALSE.
Si 'attente est TRUE, la routine doit être appelée au <IRQL = APC_LEVEL. Si 'attente est FALSE, la routine peut être appelée au <IRQL = DISPATCH_LEVEL.
Pour plus d’informations, consultez Suppression d’un objet minuteur System-Allocated.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 8.1. |
| plateforme cible | Universel |
| d’en-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| bibliothèque | Ntoskrnl.lib |
| IRQL | Voir les remarques. |