WdfTimerStop, fonction (wdftimer.h)

  • Article

[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)

Voir aussi

EvtTimerFunc

WdfTimerCreate

WdfTimerStart