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 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 d’un objet DPC framework.
Valeur de retour
WdfDpcWdmGetDpc retourne un pointeur vers la structure KDPC associée à l’objet DPC d’infrastructure spécifié.
Une vérification de bogue 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 le framework appelle WdfDpcCreate pour créer un objet DPC.
Un pilote peut appeler WdfDpcWdmGetDpc à partir de sa fonction de rappel EvtDpcFunc.
Le pointeur qui WdfDpcWdmGetDpc retourne est valide jusqu’à ce que l’objet DPC de l’infrastructure soit supprimé. Si le pilote fournit un EvtCleanupCallback fonction pour l’objet DPC framework, le pointeur est valide jusqu’à ce que la fonction de rappel retourne.
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);
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) |