WdfDpcWdmGetDpc-Funktion (wdfdpc.h)
[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) |