Função ExCancelTimer (wdm.h)
A rotina exCancelTimer cancela um temporizador 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 para NULL.
Valor de retorno
Essa rotina retornará verdadeiro se o temporizador tiver sido cancelado. Caso contrário, a rotina retornará FALSE .
Observações
Depois que o driver chamar o ExSetTimer rotina 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. Se o temporizador expirar antes de ser cancelado, ExCancelTimer retornará FALSE e o temporizador permanecerá no estado sinalizado.
Quando um temporizador expira, o sistema operacional sinaliza o objeto de temporizador. Como opção, um driver pode fornecer um exTimerCallback rotina de retorno de chamada 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 |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 8.1. |
| da Plataforma de Destino | Universal |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca | Ntoskrnl.lib |
| IRQL | <= DISPATCH_LEVEL |