ExDeleteTimer, fonction (wdm.h)
La routine ExDeleteTimer supprime un objet de minuteur qui a été 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 de 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 la valeur est TRUE, la routine annule le minuteur si le minuteur est défini. Si la valeur est FALSE, la routine n’annule pas le minuteur s’il est défini. Si l’appelant définit Wait sur TRUE, Cancel doit également avoir la valeur TRUE ; sinon, un bogue case activée se produit.
[in] Wait
Indique s’il faut attendre la fin de l’expiration du minuteur si le minuteur a déjà démarré le processus d’expiration. Si la valeur est TRUE, la routine attend l’expiration du minuteur. Si la valeur est FALSE, la routine n’attend pas. Pour plus d'informations, consultez la section Notes.
[in] Parameters
Pointeur vers une structure EXT_DELETE_PARAMETERS . Le pilote appelant a précédemment appelé la routine ExInitializeDeleteTimerParameters pour initialiser cette structure.
Valeur retournée
Cette routine retourne TRUE si Cancel a la valeur TRUE et que le minuteur a été annulé. Sinon, la routine retourne FALSE. Pour plus d'informations, consultez la section Notes.
Remarques
Une fois que votre pilote a appelé cette routine, l’objet du minuteur pointé par Timer 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 de minuteur.
Si Cancel a la valeur TRUE, la valeur de retour FALSE indique que le minuteur n’a jamais été défini ou que le minuteur a été défini mais a expiré avant qu’il puisse être annulé. Si Cancel a la valeur FALSE, la routine retourne toujours FALSE.
Cette routine peut se bloquer si Wait a la valeur TRUE. Si ExDeleteTimer est appelé à partir de la routine ExTimerCallback du pilote, qui est appelée à DISPATCH_LEVEL, le paramètre Wait dans cet appel doit être FALSE.
Si Wait a la valeur TRUE, la routine doit être appelée dans IRQL <= APC_LEVEL. Si Wait a la valeur FALSE, la routine peut être appelée à l’adresse IRQL <= DISPATCH_LEVEL.
Pour plus d’informations, consultez Suppression d’un objet minuteur System-Allocated.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 8.1. |
| Plateforme cible | Universal |
| En-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothèque | Ntoskrnl.lib |
| IRQL | Consultez la section Notes. |