WdfTimerStop, fonction (wdftimer.h)
[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 d’un objet de minuteur d’infrastructure 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 (PDC) du pilote, y compris les fonctions de rappel EvtTimerFunc du pilote, n’ont pas été exécutés.
UMDF Valeur booléenne qui, si TRUE, spécifie que l’infrastructure ne retourne pas tant que tous les appels en file d’attente à la fonction de rappel EvtTimerFunc du minuteur n’ont pas été exécutés.
Valeur retournée
WdfTimerStop retourne TRUE si l’objet du minuteur se trouvait dans la file d’attente du minuteur du système. Sinon, cette méthode retourne FALSE. Pour plus d'informations, consultez la section Notes qui suit.
Un bogue case activée 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 d’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 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 d’infrastructure, consultez Utilisation des minuteurs.
WdfTimerStop doit être appelé dans IRQL = PASSIVE_LEVEL si le paramètre Wait a la valeur TRUE. Sinon, cette méthode doit être appelée à l’adresse IRQL <= DISPATCH_LEVEL.
N’appelez pas WdfTimerStop à partir d’EvtTimerFunc avec le paramètre Wait défini sur TRUE. Cela peut entraîner un blocage.
Exemples
L’exemple de code suivant arrête un minuteur spécifié et attend que tous les PDC mis en file d’attente du pilote s’exécutent.
WdfTimerStop(
timerHandle,
TRUE
);
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Universal |
Version KMDF minimale | 1.0 |
Version UMDF minimale | 2.0 |
En-tête | wdftimer.h (inclure Wdf.h) |
Bibliothèque | Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF) |
IRQL | Consultez la section Notes. |
Règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |