Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
[S’applique uniquement à KMDF]
La méthode WdfDpcEnqueue planifie l’exécution d’une fonction de rappel EvtDpcFunc d’un objet DPC.
Syntaxe
BOOLEAN WdfDpcEnqueue(
[in] WDFDPC Dpc
);
Paramètres
[in] Dpc
Handle d’un objet DPC framework.
Valeur de retour
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 FAUX.
Une vérification de bogue 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 était 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 ultérieur à WdfDpcEnqueue ajoute l’objet DPC dans la file d’attente DPC.
Pour plus d’informations sur l’utilisation d’objets DPC, consultez Maintenance d’uned’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 contenante. L’exemple de code WdfDpcCreate montre comment l’objet DPC a été créé.
return WdfDpcEnqueue(PDevExt->CompleteWriteDpc);
Spécifications
| Besoin | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| En-tête | wdfdpc.h (include Wdf.h) |
| Bibliothèque | Wdf01000.sys (voir Versioning de la bibliothèque Framework.) |
| IRQL | N’importe quel niveau |
| règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |