Función ExDeleteTimer (wdm.h)
La rutina ExDeleteTimer elimina un objeto de temporizador asignado previamente por la rutina ExAllocateTimer.
Sintaxis
BOOLEAN ExDeleteTimer(
[in] PEX_TIMER Timer,
[in] BOOLEAN Cancel,
[in] BOOLEAN Wait,
[in] PEXT_DELETE_PARAMETERS Parameters
);
Parámetros
[in] Timer
Puntero a una estructura EX_TIMER. Esta estructura es un objeto de temporizador asignado previamente por la rutina ExAllocateTimer.
[in] Cancel
Si desea cancelar el temporizador si está establecido actualmente. Si TRUE, la rutina cancela el temporizador si se establece el temporizador. Si FALSE, la rutina no cancela el temporizador si se establece. Si el autor de la llamada establece de espera para TRUE, Cancelar también debe ser TRUE; De lo contrario, se produce una comprobación de errores.
[in] Wait
Si desea esperar a que el temporizador termine de expirar si el temporizador ya ha iniciado el proceso de expiración. Si TRUE, la rutina espera a que expire el temporizador. Si FALSE, la rutina no espera. Para obtener más información, vea Comentarios.
[in] Parameters
Puntero a una estructura EXT_DELETE_PARAMETERS. El controlador de llamada llamó anteriormente a la rutina ExInitializeDeleteTimerParameters para inicializar esta estructura.
Valor devuelto
Esta rutina devuelve TRUE si Cancelar es TRUE y se canceló el temporizador. De lo contrario, la rutina devuelve FALSE. Para obtener más información, vea Comentarios.
Observaciones
Después de que el controlador llame a esta rutina, es posible que el objeto de temporizador al que apunta timer ya no sea válido. Sin embargo, el valor del parámetro timer de pasado a un exTimerCallback rutina de devolución de llamada, si el controlador implementa esta rutina, siempre es un puntero válido a un objeto de temporizador.
Si Cancelar es TRUE, un valor devuelto de FALSE indica que el temporizador nunca se estableció o que el temporizador se estableció pero expiró antes de que se pudiera cancelar. Si cancelar es FALSE, la rutina siempre devuelve FALSE.
Esta rutina puede bloquear si de espera de es TRUE. Si se llama ExDeleteTimer desde la rutina exTimerCallback del controlador, que se llama a DISPATCH_LEVEL, el parámetro Wait de esta llamada debe ser FALSE.
Si de espera es TRUE, se debe llamar a la rutina en IRQL <= APC_LEVEL. Si de espera es FALSE, se puede llamar a la rutina en IRQL <= DISPATCH_LEVEL.
Para obtener más información, vea Eliminar un objeto timer de System-Allocated.
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 | Vea comentarios. |