Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[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
);
Die Parameter
[in] Dpc
Ein Handle zu einem Framework-DPC-Objekt.
Rückgabewert
WdfDpcWdmGetDpc gibt einen Zeiger auf die KDPC- Struktur zurück, die dem angegebenen Framework-DPC-Objekt zugeordnet ist.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Bemerkungen
Das Framework erstellt eine KDPC-Struktur, wenn ein frameworkbasierter Treiber WdfDpcCreate aufruft, um ein DPC-Objekt zu erstellen.
Ein Treiber ruft möglicherweise WdfDpcWdmGetDpc innerhalb seiner EvtDpcFunc- Rückruffunktion auf.
Der Zeiger, der WdfDpcWdmGetDpc zurückgibt, 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 |
| Minimale KMDF-Version | 1.0 |
| Kopfzeile | wdfdpc.h (enthalten Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.) |
| IRQL | Beliebige Ebene |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |