WdfTimerStop, fonction (wdftimer.h)

Article
11/08/2024

[S’applique à KMDF et UMDF]

La méthode WdfTimerStop arrête l’horloge d’un minuteur.

Syntaxe

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

Paramètres

[in] Timer

Handle vers un objet de minuteur de framework obtenu en appelant WdfTimerCreate.

[in] Wait

KMDF Valeur booléenne qui, si TRUE, spécifie que l’infrastructure ne retourne pas tant que tous les appels en file d’attente aux appels de procédure différée du pilote (DPC), y compris les fonctions de rappel EvtTimerFunc du pilote, ont été exécutés.

UMDF Valeur booléenne qui, si TRUE, spécifie que l’infrastructure ne retourne pas tant que tous les appels mis en file d’attente à la fonction de rappel EvtTimerFunc evtTimerFunc n’ont pas été exécutés.

Valeur de retour

WdfTimerStop retourne TRUE si l’objet minuteur était dans la file d’attente du minuteur du système. Sinon, cette méthode retourne FALSE. Pour plus d’informations, consultez la section Remarques suivante.

Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.

Remarques

Lorsqu’un pilote appelle WdfTimerStart, son objet minuteur est ajouté à la file d’attente des objets du minuteur du système. Si le minuteur n’est pas un minuteur périodique, le système supprime l’objet minuteur de la file d’attente une fois que le délai d’échéance du minuteur s’est écoulé. Si le minuteur est un minuteur périodique, l’objet minuteur reste dans la file d’attente jusqu’à ce que le pilote appelle WdfTimerStop.

Pour plus d’informations sur les objets du minuteur de framework, consultez Using Timers.

WdfTimerStop doit être appelée à IRQL = PASSIVE_LEVEL si le paramètre Wait est TRUE. Sinon, cette méthode doit être appelée au <IRQL = DISPATCH_LEVEL.

N’appelez pas WdfTimerStop à partir de EvtTimerFunc avec le paramètre Wait défini sur TRUE. Cela peut entraîner un blocage.

Prudence

Les appels simultanés à WdfTimerStop sur le même objet minuteur se décomposent dans le débogueur si le vérificateur est activé. Pour plus d’informations, consultez Utilisation du vérificateur KMDF.

Exemples

L’exemple de code suivant arrête un minuteur spécifié et attend l’exécution de tous les DPC mis en file d’attente du pilote.

WdfTimerStop(
             timerHandle,
             TRUE
             );

Exigences

Exigence	Valeur
plateforme cible	Universel
version minimale de KMDF	1.0
version minimale de UMDF	2.0
d’en-tête	wdftimer.h (include Wdf.h)
bibliothèque	Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF)
IRQL	Voir la section Remarques.
règles de conformité DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

EvtTimerFunc

WdfTimerCreate

WdfTimerStart

Partager via