Función KeInitializeTimerEx (wdm.h)

Artículo
08/08/2023

La rutina KeInitializeTimerEx inicializa un objeto de temporizador de kernel extendido.

Sintaxis

void KeInitializeTimerEx(
  [out] PKTIMER    Timer,
  [in]  TIMER_TYPE Type
);

Parámetros

[out] Timer

Puntero a un objeto de temporizador, para el que el autor de la llamada proporciona el almacenamiento.

[in] Type

Especifica el tipo del objeto de temporizador, NotificationTimer o SynchronizationTimer.

Valor devuelto

None

Observaciones

El objeto de temporizador se inicializa en un estado no señalado.

El almacenamiento de un objeto de temporizador debe residir: en la extensión del dispositivo de un objeto de dispositivo creado por el controlador, en la extensión del controlador de un objeto de controlador creado por el controlador o en un grupo no paginado asignado por el autor de la llamada.

Cuando expira un temporizador de notificación, se liberan todos los subprocesos en espera y el temporizador permanece en el estado señalado hasta que se restablece explícitamente. Cuando expira un temporizador de sincronización, se establece en un estado señalado hasta que se libera un único subproceso en espera y, a continuación, el temporizador se restablece a un estado no señalado.

Los autores de llamadas de KeInitializeTimerEx deben ejecutarse en IRQL = DISPATCH_LEVEL o inferior. Es mejor inicializar temporizadores en IRQL = PASSIVE_LEVEL.

Para obtener más información sobre los objetos de temporizador, vea Objetos de temporizador y DDC.

Use KeSetTimer o KeSetTimerEx para definir cuándo expirará el temporizador.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 2000.
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL (consulte la sección Comentarios)
Reglas de cumplimiento de DDI	HwStorPortProhibitedDIs(storport), IrqlKeDispatchLte(wdm)