Funzione KeCancelTimer (wdm.h)
La routine KeCancelTimer dequeue un oggetto timer prima dell'intervallo timer, se è stato impostato, scade.
Sintassi
BOOLEAN KeCancelTimer(
[in, out] PKTIMER unnamedParam1
);
Parametri
[in, out] unnamedParam1
Puntatore a un oggetto timer inizializzato, per il quale il chiamante fornisce l'archiviazione.
Valore restituito
Se l'oggetto timer specificato si trova nella coda timer di sistema, KeCancelTimer restituisce TRUE.
Commenti
Se l'oggetto timer è attualmente presente nella coda timer di sistema, viene rimosso dalla coda. Se un oggetto DPC è associato al timer, viene annullato. In caso contrario, non viene eseguita alcuna operazione.
La routine restituisce TRUE se il timer è ancora nella coda timer. Un timer nonperiodic viene rimosso dalla coda di sistema non appena scade. Pertanto, per i timer nonperiodici, KeCancelTimer restituisce FALSE se il timer DPC è stato accodato. I timer periodici si trovano sempre nella coda timer, quindi KeCancelTimer restituisce sempre TRUE per i timer periodici.
Si noti che un DPC già in esecuzione viene eseguito al completamento. Il driver deve assicurarsi che il DPC sia stato completato prima di liberare tutte le risorse usate dal DPC. Per un timer nonperiodic, è possibile usare le primitive di sincronizzazione, ad esempio oggetti evento, per sincronizzare tra il driver e il DPC. Il driver può controllare il codice restituito di KeCancelTimer per determinare se il DPC è in esecuzione. In tal caso, il DPC può segnalare l'evento prima di uscire e il driver può attendere che tale evento venga reimpostato allo stato non segnalato.
Poiché per i timer periodici KeCancelTimer restituisce sempre TRUE, i driver devono usare una tecnica diversa per attendere il completamento del DPC. Usare la routine KeFlushQueuedDpcs per bloccare fino all'esecuzione del DPC.
I driver non devono essere sincronizzati per i dati archiviati in variabili globali o estensioni dell'oggetto driver. Il sistema chiama automaticamente KeFlushQueuedDpcs prima di deallocare una di queste aree.
Per altre informazioni sugli oggetti timer, vedere Oggetti timer e schede di rete.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 2000. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| Regole di conformità DDI | HwStorPortProhibitedDDDIs(storport), IrqlKeDispatchLte(wdm) |