KeInitializeTimer, fonction (wdm.h)
La routine KeInitializeTimer initialise un objet minuteur.
Syntaxe
void KeInitializeTimer(
[out] PKTIMER Timer
);
Paramètres
[out] Timer
Pointeur vers un objet minuteur pour lequel l’appelant fournit le stockage.
Valeur de retour
Aucun
Remarques
L’objet minuteur est initialisé à un état non signalé.
Le stockage d’un objet minuteur doit être résident : dans l’extension de périphérique d’un objet de périphérique créé par le pilote, dans l’extension du contrôleur d’un objet de contrôleur créé par un pilote ou dans un pool non paginé alloué par l’appelant.
KeInitializeTimer ne peut initialiser qu’un minuteur de notification. Utilisez KeInitializeTimerEx pour initialiser un minuteur de notification ou un minuteur de synchronisation.
Utilisez keSetTimer ou KeSetTimerEx pour définir quand le minuteur expire.
Pour plus d’informations sur les objets du minuteur, consultez objets de minuteur et les contrôleurs de domaine.
Les appelants de KeInitializeTimer doivent s’exécuter à IRQL = DISPATCH_LEVEL ou inférieur. Il est préférable d’initialiser des minuteurs à IRQL = PASSIVE_LEVEL.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 2000. |
| plateforme cible | Universel |
| d’en-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL (voir la section Remarques) |
| règles de conformité DDI | HwStorPortProhibitedDDIs(storport), IrqlKeDispatchLte(wdm) |