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 |