Función ExCancelTimer (wdm.h)

La rutina ExCancelTimer cancela un temporizador establecido por una llamada anterior a la rutina ExSetTimer .

Sintaxis

BOOLEAN ExCancelTimer(
  [in, out]      PEX_TIMER              Timer,
  [in, optional] PEXT_CANCEL_PARAMETERS Parameters
);

Parámetros

[in, out] Timer

Puntero a una estructura de EX_TIMER . Esta estructura es un objeto de temporizador asignado previamente por la rutina ExAllocateTimer .

[in, optional] Parameters

Los controladores deben establecer este parámetro en NULL.

Valor devuelto

Esta rutina devuelve TRUE si se canceló el temporizador. De lo contrario, la rutina devuelve FALSE.

Comentarios

Después de que el controlador llame a la rutina ExSetTimer para establecer el temporizador, es posible que el temporizador se cancele antes de que expire. El controlador puede llamar a la rutina ExCancelTimer para cancelar explícitamente un temporizador pendiente. Además, si el controlador llama a la rutina ExSetTimer para establecer un nuevo temporizador en un objeto de temporizador antes de que expire un temporizador establecido anteriormente en este objeto, esta llamada a ExSetTimer cancela implícitamente el temporizador anterior y, a continuación, inicia el nuevo temporizador.

Un valor devuelto de TRUE indica que el temporizador se estableció cuando se llamó a ExCancelTimer . En este caso, la rutina cancela el temporizador. Un valor devuelto de FALSE indica que el temporizador no se estableció, lo que podría significar que el temporizador nunca se estableció, que el temporizador ya se había cancelado o que el temporizador ya había expirado.

Cuando expira un temporizador, el sistema operativo señala el objeto de temporizador. Como opción, un controlador puede proporcionar una rutina de devolución de llamada exTimerCallback a la que se llama cuando expira el temporizador. Si el controlador proporciona esta rutina de devolución de llamada, se garantiza que se llame a esta rutina si se señala el objeto de temporizador. Si el temporizador se cancela antes de que expire, no se señala el objeto de temporizador y no se llama a la rutina de devolución de llamada.

Para obtener más información, vea ExXxxTimer Routines and EX_TIMER Objects.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 8.1.
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library	Ntoskrnl.lib
IRQL	<= DISPATCH_LEVEL

Consulte también

EX_TIMER

ExAllocateTimer

ExSetTimer