WdfDpcEnqueue, fonction (wdfdpc.h)

[S’applique à KMDF uniquement]

La méthode WdfDpcEnqueue planifie l’exécution de la fonction de rappel EvtDpcFunc d’un objet DPC.

Syntaxe

BOOLEAN WdfDpcEnqueue(
  [in] WDFDPC Dpc
);

Paramètres

[in] Dpc

Handle pour un objet DPC d’infrastructure.

Valeur retournée

WdfDpcEnqueue retourne TRUE s’il ajoute correctement l’objet DPC spécifié à la file d’attente DPC du système. Sinon, la méthode retourne FALSE.

Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.

Remarques

La méthode WdfDpcEnqueue ajoute l’objet DPC spécifié à la file d’attente DPC du système, s’il n’est pas déjà dans la file d’attente. (Si l’objet DPC se trouvait déjà dans la file d’attente, la méthode retourne FALSE.) Lorsque le système n’exécute pas de tâches de priorité supérieure, il supprime l’objet DPC de la file d’attente et appelle la fonction de rappel EvtDpcFunc de l’objet.

Une fois la fonction de rappel exécutée, un appel suivant à WdfDpcEnqueue rajoute l’objet DPC dans la file d’attente DPC.

Pour plus d’informations sur l’utilisation d’objets DPC, consultez Maintenance d’une interruption.

Exemples

L’exemple de code suivant planifie l’exécution de la fonction de rappel associée à un objet DPC. L’exemple utilise la valeur de retour de la méthode WdfDpcEnqueue comme valeur de retour de la fonction conteneur. L’exemple de code WdfDpcCreate montre comment l’objet DPC a été créé.

return WdfDpcEnqueue(PDevExt->CompleteWriteDpc);

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
En-tête	wdfdpc.h (inclure Wdf.h)
Bibliothèque	Wdf01000.sys (consultez Gestion des versions de la bibliothèque d’infrastructure).)
IRQL	N’importe quel niveau
Règles de conformité DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

EvtDpcFunc

WdfDpcCreate