Fonction ExSetTimer (wdm.h)

La routine ExSetTimer démarre une opération de minuterie et définit le minuteur pour qu’il expire à l’heure d’échéance spécifiée.

Syntaxe

BOOLEAN ExSetTimer(
  [in]           PEX_TIMER           Timer,
  [in]           LONGLONG            DueTime,
  [in]           LONGLONG            Period,
  [in, optional] PEXT_SET_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] DueTime

Heure absolue ou relative à laquelle le minuteur doit expirer. Si la valeur du paramètre DueTime est négative, l’heure d’expiration est relative à l’heure système actuelle. Sinon, le délai d’expiration est absolu. Le temps d’expiration est exprimé en unités de temps système (intervalles de 100 nanosecondes). Les heures d’expiration absolues suivent les modifications apportées à l’heure système ; les heures d’expiration relatives ne sont pas affectées par les changements d’heure système. Un temps absolu est exprimé comme le temps passé, en unités de temps système, depuis le début de l’année 1601.

Le paramètre DueTime d’un minuteur à haute résolution doit être une heure relative (valeur négative) ou des vérifications de bogues de routine.

[in] Period

Période facultative pour le minuteur dans les unités de temps système (intervalles de 100 nanosecondes). Doit être inférieur ou égal à MAXLONG. Pour un minuteur qui est one-shot au lieu de périodique, définissez Période sur zéro.

[in, optional] Parameters

Pointeur vers une structure EXT_SET_PARAMETERS . Le pilote appelant appelait précédemment la routine ExInitializeSetTimerParameters pour initialiser cette structure.

Valeur retournée

Cette routine retourne TRUE si elle annule un minuteur qui était en attente au moment où la routine a été appelée. Sinon, la routine retourne FALSE. Pour plus d'informations, consultez la section Notes.

Remarques

Votre pilote peut appeler cette routine pour définir un minuteur pour qu’il expire à un moment ultérieur. Le pilote peut alors attendre l’expiration du minuteur. Le pilote peut également implémenter une routine de rappel appelée à l’expiration du minuteur.

Une fois qu’un pilote appelle ExSetTimer, le pilote peut appeler une routine telle que KeWaitForSingleObject ou KeWaitForMultipleObjects pour attendre l’expiration du minuteur. Lorsque le minuteur expire, le système d’exploitation signale l’objet minuteur.

En option, le pilote peut implémenter une routine de rappel ExTimerCallback et fournir un pointeur vers cette routine en tant que paramètre d’entrée vers la routine ExAllocateTimer . Lorsque le minuteur expire, le système d’exploitation appelle la routine ExTimerCallback .

Un appel ExSetTimer annule implicitement toute opération set-timer précédemment démarrée sur l’objet minuteur spécifié par Timer. Si votre pilote a précédemment appelé ExSetTimer pour définir un minuteur qui utilise le minuteur et que ce minuteur n’a pas encore expiré quand ExSetTimer est appelé une deuxième fois, le deuxième appel annule le minuteur du premier appel, puis démarre le nouveau minuteur. Dans ce cas, le deuxième appel retourne TRUE. Toutefois, si le minuteur démarré par le premier appel expire avant que le deuxième appel puisse annuler ce minuteur, le deuxième appel démarre le nouveau minuteur et retourne FALSE.

Si le paramètre Period est différent de zéro, le minuteur est périodique. Pour un minuteur périodique, le paramètre DueTime spécifie l’heure d’expiration du minuteur initial et Period spécifie l’intervalle entre les expirations suivantes.

Le minuteur matériel utilisé pour l’horloge système signale les demandes d’interruption à intervalles uniformes, mais la gestion de ces interruptions peut être retardée par le traitement des interruptions pour d’autres appareils. Ainsi, pour un minuteur périodique, le délai entre une heure d’expiration périodique et l’heure à laquelle l’objet du minuteur est signalé ou à laquelle la routine ExTimerCallback s’exécute peut varier d’une période à l’autre. Pour plus d’informations, consultez Précision du minuteur.

Un minuteur périodique ne peut pas expirer plus d’une fois par horloge système. Le fait de définir la période d’un minuteur sur une valeur inférieure à l’intervalle entre les cycles d’horloge système n’entraîne pas l’expiration de la minuterie plusieurs fois par le coche d’horloge système, mais peut entraîner la variation des intervalles entre les expirations successives si le taux d’horloge système change. Par exemple, le système d’exploitation peut augmenter temporairement la fréquence d’horloge du système pour répondre aux exigences de minutage d’un minuteur haute résolution. Pour plus d’informations, consultez Minuteurs haute résolution.

Pour un minuteur périodique qui n’est pas un minuteur à haute résolution, un pilote peut obtenir des expirations périodiques relativement uniformes en définissant Period sur un multiple entier de l’intervalle par défaut entre les cycles d’horloge système.

Pour éviter une consommation excessive d’énergie, un pilote ne doit pas définir la période d’un minuteur à haute résolution de longue durée sur une valeur inférieure à l’intervalle par défaut entre les cycles d’horloge système. Dans le cas contraire, le minuteur d’horloge système génère en permanence des interruptions à la fréquence d’horloge système maximale autorisée.

Pour plus d’informations, consultez Routines et EX_TIMER Objects ExXxxTimer.

Configuration requise

Voir aussi

EXT_SET_PARAMETERS

EX_TIMER

ExAllocateTimer

ExInitializeSetTimerParameters

ExTimerCallback

KeWaitForMultipleObjects

KeWaitForSingleObject