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

Voir aussi

EX_TIMER

ExAllocateTimer

ExSetTimer