Fonction KeInitializeTimer (wdm.h)

Article
02/27/2024

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

None

Remarques

L’objet minuteur est initialisé à un état non signalé.

Le stockage d’un objet minuteur doit être résident : dans l’extension d’appareil d’un objet d’appareil créé par un pilote, dans l’extension de contrôleur d’un objet contrôleur créé par le 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 du minuteur et PDC.

Les appelants de KeInitializeTimer doivent être en cours d’exécution à IRQL = DISPATCH_LEVEL ou inférieur. Il est préférable d’initialiser les minuteurs à IRQL = PASSIVE_LEVEL.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 2000.
Plateforme cible	Universal
En-tête	wdm.h (inclure 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)