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