WdfDpcWdmGetDpc-Funktion (wdfdpc.h)

Artikel
02/27/2024

[Gilt nur für KMDF]

Die WdfDpcWdmGetDpc-Methode gibt einen Zeiger auf die KDPC-Struktur zurück, die einem angegebenen Framework-DPC-Objekt zugeordnet ist.

Syntax

PKDPC WdfDpcWdmGetDpc(
  [in] WDFDPC Dpc
);

Parameter

[in] Dpc

Ein Handle für ein Framework-DPC-Objekt.

Rückgabewert

WdfDpcWdmGetDpc gibt einen Zeiger auf die KDPC-Struktur zurück, die dem angegebenen Framework-DPC-Objekt zugeordnet ist.

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Hinweise

Das Framework erstellt eine KDPC-Struktur, wenn ein frameworkbasierter Treiber WdfDpcCreate aufruft, um ein DPC-Objekt zu erstellen.

Ein Treiber kann WdfDpcWdmGetDpc innerhalb seiner EvtDpcFunc-Rückruffunktion aufrufen.

Der von WdfDpcWdmGetDpc zurückgegebene Zeiger ist gültig, bis das Framework-DPC-Objekt gelöscht wird. Wenn der Treiber eine EvtCleanupCallback-Funktion für das Framework-DPC-Objekt bereitstellt, ist der Zeiger gültig, bis die Rückruffunktion zurückgegeben wird.

Beispiele

Im folgenden Codebeispiel wird ein Zeiger auf die KDPC-Struktur zurückgegeben, die einem angegebenen DPC-Objekt zugeordnet ist. Das WdfDpcCreate-Codebeispiel zeigt, wie das angegebene DPC-Objekt erstellt wurde.

PKDPC pWdmDpc;

pWdmDpc = WdfDpcWdmGetDpc(PDevExt->CompleteWriteDpc);

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
Kopfzeile	wdfdpc.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.)
IRQL	Beliebige Ebene
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen