Funzione WdfTimerStop (wdftimer.h)

[Si applica a KMDF e UMDF]

Il metodo WdfTimerStop arresta l'orologio di un timer.

Sintassi

BOOLEAN WdfTimerStop(
  [in] WDFTIMER Timer,
  [in] BOOLEAN  Wait
);

Parametri

[in] Timer

Handle per un oggetto timer del framework ottenuto chiamando WdfTimerCreate.

[in] Wait

KMDF Valore booleano che, se TRUE, specifica che il framework non restituisce finché non vengono eseguite tutte le chiamate in coda alle chiamate di routine posticipate del driver, incluse le funzioni di callback EvtTimerFunc del driver.

UMDF Valore booleano che, se TRUE, specifica che il framework non restituisce finché non vengono eseguite tutte le chiamate in coda alla funzione di callback EvtTimerFunc del timer.

Valore restituito

WdfTimerStop restituisce TRUE se l'oggetto timer si trovava nella coda timer del sistema. In caso contrario, questo metodo restituisce FALSE. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Commenti

Quando un driver chiama WdfTimerStart, il relativo oggetto timer viene aggiunto alla coda di oggetti timer del sistema. Se il timer non è un timer periodico, il sistema rimuove l'oggetto timer dalla coda dopo che è trascorso il "tempo di scadenza" del timer. Se il timer è un timer periodico, l'oggetto timer rimane nella coda finché il driver non chiama WdfTimerStop.

Per altre informazioni sugli oggetti timer del framework, vedere Uso di timer.

WdfTimerStop deve essere chiamato in IRQL = PASSIVE_LEVEL se il parametro Wait è TRUE. In caso contrario, questo metodo deve essere chiamato in IRQL <= DISPATCH_LEVEL.

Non chiamare WdfTimerStop dall'interno di EvtTimerFunc con il parametro Wait impostato su TRUE. In questo modo può verificarsi un deadlock.

Esempio

L'esempio di codice seguente arresta un timer specificato e attende l'esecuzione di tutti i DPC in coda del driver.

WdfTimerStop(
             timerHandle,
             TRUE
             );

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Versione UMDF minima	2,0
Intestazione	wdftimer.h (include Wdf.h)
Libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	Vedere la sezione Osservazioni.
Regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

EvtTimerFunc

WdfTimerCreate

WdfTimerStart