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 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.
Observaciones
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, este ExSetTimer llamada cancela implícitamente el temporizador anterior y, a continuación, inicia el nuevo temporizador.
Un valor devuelto de TRUE indica que se estableció el temporizador cuando se llamó a exCancelTimer. En este caso, la rutina cancela el temporizador. Un valor devuelto de FALSE indica que no se estableció el temporizador, 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. Si el temporizador expira antes de que se cancele, ExCancelTimer devuelve FALSE y el temporizador permanece en estado señalado.
Cuando expira un temporizador, el sistema operativo indica el objeto de temporizador. Como opción, un controlador puede proporcionar una rutina de devolución de llamada ExTimerCall back 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 del temporizador. Si el temporizador se cancela antes de que expire, no se señala el objeto del 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 | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de Windows 8.1. |
| de la plataforma de destino de | Universal |
| encabezado de | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca de | Ntoskrnl.lib |
| irQL | <= DISPATCH_LEVEL |