Funzione ExCancelTimer (wdm.h)
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 |