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 WdfDpcEnqueue Methode plant die Ausführung der EvtDpcFunc Rückruffunktion eines DPC-Objekts.
Syntax
BOOLEAN WdfDpcEnqueue(
[in] WDFDPC Dpc
);
Die Parameter
[in] Dpc
Ein Handle zu einem Framework-DPC-Objekt.
Rückgabewert
WdfDpcEnqueue gibt TRUE- zurück, wenn das angegebene DPC-Objekt erfolgreich zur DPC-Warteschlange des Systems hinzugefügt wird. Andernfalls gibt die Methode FALSE-zurück.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Bemerkungen
Die WdfDpcEnqueue Methode fügt das angegebene DPC-Objekt der DPC-Warteschlange des Systems hinzu, sofern es nicht bereits in der Warteschlange enthalten ist. (Wenn sich das DPC-Objekt bereits in der Warteschlange befand, gibt die Methode FALSEzurück.) Wenn das System keine Aufgaben mit höherer Priorität ausführt, entfernt es das DPC-Objekt aus der Warteschlange und ruft die EvtDpcFunc Rückruffunktion des Objekts auf.
Nachdem die Rückruffunktion ausgeführt wurde, fügt ein anschließender Aufruf von WdfDpcEnqueue das DPC-Objekt wieder in die DPC-Warteschlange ein.
Weitere Informationen zur Verwendung von DPC-Objekten finden Sie unter Servicing an Interrupt.
Beispiele
Im folgenden Codebeispiel wird die Ausführung der Rückruffunktion geplant, die einem DPC-Objekt zugeordnet ist. Im Beispiel wird der Rückgabewert der WdfDpcEnqueue Methode als Rückgabewert der enthaltenden Funktion verwendet. Das WdfDpcCreate Codebeispiel zeigt, wie das DPC-Objekt erstellt wurde.
return WdfDpcEnqueue(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) |