ExDeleteTimer, fonction (wdm.h)

Article
02/27/2024

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.