Função ExCancelTimer (wdm.h)
A rotina ExCancelTimer cancela um temporizador que foi definido por uma chamada anterior para a rotina exSetTimer .
Sintaxe
BOOLEAN ExCancelTimer(
[in, out] PEX_TIMER Timer,
[in, optional] PEXT_CANCEL_PARAMETERS Parameters
);
Parâmetros
[in, out] Timer
Um ponteiro para uma estrutura EX_TIMER . Essa estrutura é um objeto de temporizador que foi alocado anteriormente pela rotina ExAllocateTimer .
[in, optional] Parameters
Os drivers devem definir esse parâmetro como NULL.
Retornar valor
Essa rotina retornará TRUE se o temporizador tiver sido cancelado. Caso contrário, a rotina retornará FALSE.
Comentários
Depois que o driver chamar a rotina exSetTimer para definir o temporizador, o temporizador poderá ser cancelado antes de expirar. O driver pode chamar a rotina ExCancelTimer para cancelar explicitamente um temporizador pendente. Além disso, se o driver chamar a rotina ExSetTimer para definir um novo temporizador em um objeto de temporizador antes que um temporizador definido anteriormente neste objeto expire, essa chamada exSetTimer cancelará implicitamente o temporizador anterior e iniciará o novo temporizador.
Um valor retornado de TRUE indica que o temporizador foi definido quando ExCancelTimer foi chamado. Nesse caso, a rotina cancela o temporizador. Um valor retornado de FALSE indica que o temporizador não foi definido, o que pode significar que o temporizador nunca foi definido, que o temporizador já havia sido cancelado ou que o temporizador já havia expirado.
Quando um temporizador expira, o sistema operacional sinaliza o objeto de temporizador. Como opção, um driver pode fornecer uma rotina de retorno de chamada ExTimerCallback que é chamada quando o temporizador expira. Se o driver fornecer essa rotina de retorno de chamada, essa rotina será chamada se o objeto de temporizador for sinalizado. Se o temporizador for cancelado antes de expirar, o objeto de temporizador não será sinalizado e a rotina de retorno de chamada não será chamada.
Para obter mais informações, consulte Rotinas exXxxTimer e objetos EX_TIMER.
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 | <= DISPATCH_LEVEL |