Funzione ExCancelTimer (wdm.h)

  • Articolo

La routine ExCancelTimer annulla un timer impostato da una chiamata precedente alla routine ExSetTimer .

Sintassi

BOOLEAN ExCancelTimer(
  [in, out]      PEX_TIMER              Timer,
  [in, optional] PEXT_CANCEL_PARAMETERS Parameters
);

Parametri

[in, out] Timer

Puntatore a una struttura EX_TIMER . Questa struttura è un oggetto timer allocato in precedenza dalla routine ExAllocateTimer .

[in, optional] Parameters

I driver devono impostare questo parametro su NULL.

Valore restituito

Questa routine restituisce TRUE se il timer è stato annullato. In caso contrario, la routine restituisce FALSE.

Commenti

Dopo che il driver chiama la routine ExSetTimer per impostare il timer, il timer potrebbe essere annullato prima della scadenza. Il driver può chiamare la routine ExCancelTimer per annullare in modo esplicito un timer in sospeso. Inoltre, se il driver chiama la routine ExSetTimer per impostare un nuovo timer su un oggetto timer prima della scadenza di un timer impostato in precedenza su questo oggetto, questa chiamata di ExSetTimer annulla in modo implicito il timer precedente e quindi avvia il nuovo timer.

Un valore restituito TRUE indica che il timer è stato impostato quando è stato chiamato ExCancelTimer . In questo caso, la routine annulla il timer. Un valore restituito FALSE indica che il timer non è stato impostato, il che potrebbe significare che il timer non è mai stato impostato, che il timer era già stato annullato o che il timer era già scaduto.

Alla scadenza di un timer, il sistema operativo segnala l'oggetto timer. Come opzione, un driver può fornire una routine di callback ExTimerCallback che viene chiamata alla scadenza del timer. Se il driver fornisce questa routine di callback, questa routine viene chiamata se viene segnalato l'oggetto timer. Se il timer viene annullato prima della scadenza, l'oggetto timer non viene segnalato e la routine di callback non viene chiamata.

Per altre informazioni, vedere Routine di ExXxxTimer e oggetti EX_TIMER.

Requisiti

Requisito Valore
Client minimo supportato Disponibile a partire da Windows 8.1.
Piattaforma di destinazione Universale
Intestazione wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria Ntoskrnl.lib
IRQL <= DISPATCH_LEVEL

Vedi anche

EX_TIMER

ExAllocateTimer

ExSetTimer