Função ExDeleteTimer (wdm.h)
A rotina ExDeleteTimer exclui um objeto de temporizador que foi alocado anteriormente pela rotina ExAllocateTimer .
Sintaxe
BOOLEAN ExDeleteTimer(
[in] PEX_TIMER Timer,
[in] BOOLEAN Cancel,
[in] BOOLEAN Wait,
[in] PEXT_DELETE_PARAMETERS Parameters
);
Parâmetros
[in] Timer
Um ponteiro para uma estrutura EX_TIMER . Essa estrutura é um objeto de temporizador que foi alocado anteriormente pela rotina ExAllocateTimer .
[in] Cancel
Se o temporizador deve ser cancelado se ele estiver definido no momento. Se TRUE, a rotina cancelará o temporizador se o temporizador estiver definido. Se FALSE, a rotina não cancelará o temporizador se ele estiver definido. Se o chamador definir Wait como TRUE, Cancel também deverá ser TRUE; caso contrário, ocorrerá um bug marcar.
[in] Wait
Se o temporizador deve ser aguardado para concluir a expiração se o temporizador já tiver iniciado o processo de expiração. Se TRUE, a rotina aguarda o temporizador expirar. Se FALSE, a rotina não aguarda. Para obter mais informações, consulte Comentários.
[in] Parameters
Um ponteiro para uma estrutura EXT_DELETE_PARAMETERS . O driver de chamada anteriormente chamou a rotina ExInitializeDeleteTimerParameters para inicializar essa estrutura.
Retornar valor
Essa rotina retornará TRUE se Cancel for TRUE e o temporizador for cancelado. Caso contrário, a rotina retornará FALSE. Para obter mais informações, consulte Comentários.
Comentários
Depois que o driver chama essa rotina, o objeto de temporizador apontado pelo Timer pode não ser mais válido. No entanto, o valor do parâmetro Timer passado para uma rotina de retorno de chamada ExTimerCallback , se o driver implementar essa rotina, será sempre um ponteiro válido para um objeto de temporizador.
Se Cancel for TRUE, um valor retornado de FALSE indicará que o temporizador nunca foi definido ou que o temporizador foi definido, mas expirou antes de ser cancelado. Se Cancelar for FALSE, a rotina sempre retornará FALSE.
Essa rotina pode bloquear se Wait for TRUE. Se ExDeleteTimer for chamado da rotina ExTimerCallback do driver, que é chamada em DISPATCH_LEVEL, o parâmetro Wait nessa chamada deverá ser FALSE.
Se Wait for TRUE, a rotina deverá ser chamada em IRQL <= APC_LEVEL. Se Wait for FALSE, a rotina poderá ser chamada em IRQL <= DISPATCH_LEVEL.
Para obter mais informações, consulte Excluindo um objeto timer System-Allocated.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 8.1. |
| Plataforma de Destino | Universal |
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Biblioteca | Ntoskrnl.lib |
| IRQL | Consulte Observações. |