WdfDpcWdmGetDpc, fonction (wdfdpc.h)
[S’applique à KMDF uniquement]
La méthode WdfDpcWdmGetDpc retourne un pointeur vers la structure KDPC associée à un objet DPC d’infrastructure spécifié.
Syntaxe
PKDPC WdfDpcWdmGetDpc(
[in] WDFDPC Dpc
);
Paramètres
[in] Dpc
Handle pour un objet DPC d’infrastructure.
Valeur retournée
WdfDpcWdmGetDpc retourne un pointeur vers la structure KDPC associée à l’objet DPC d’infrastructure spécifié.
Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.
Remarques
L’infrastructure crée une structure KDPC lorsqu’un pilote basé sur l’infrastructure appelle WdfDpcCreate pour créer un objet DPC.
Un pilote peut appeler WdfDpcWdmGetDpc à partir de sa fonction de rappel EvtDpcFunc .
Le pointeur retourné par WdfDpcWdmGetDpc est valide jusqu’à ce que l’objet DPC d’infrastructure soit supprimé. Si le pilote fournit une fonction EvtCleanupCallback pour l’objet DPC d’infrastructure, le pointeur est valide jusqu’à ce que la fonction de rappel soit retournée.
Exemples
L’exemple de code suivant retourne un pointeur vers la structure KDPC associée à un objet DPC spécifié. L’exemple de code WdfDpcCreate montre comment l’objet DPC spécifié a été créé.
PKDPC pWdmDpc;
pWdmDpc = WdfDpcWdmGetDpc(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) |