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

Confira também

EX_TIMER

ExAllocateTimer

ExSetTimer