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)

Voir aussi

EvtDpcFunc

KDPC

WDF_DPC_CONFIG

WdfDpcCreate