WdfDpcEnqueue-Funktion (wdfdpc.h)

[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
);

Parameter

[in] Dpc

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

Rückgabewert

WdfDpcEnqueue gibt TRUE zurück, wenn das angegebene DPC-Objekt erfolgreich der DPC-Warteschlange des Systems hinzugefügt wird. Andernfalls gibt die Methode FALSE zurück.

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

Hinweise

Die WdfDpcEnqueue-Methode fügt das angegebene DPC-Objekt der DPC-Warteschlange des Systems hinzu, sofern es sich nicht bereits in der Warteschlange befindet. (Wenn sich das DPC-Objekt bereits in der Warteschlange befand, gibt die Methode FALSE zurü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, wird das DPC-Objekt durch einen nachfolgenden Aufruf von WdfDpcEnqueue wieder der DPC-Warteschlange hinzugefügt.

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
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

EvtDpcFunc

WdfDpcCreate