WdfDeviceWdmDispatchIrp-Funktion (wdfdevice.h)

  • Artikel

[Gilt für KMDF und UMDF]

Die WdfDeviceWdmDispatchIrp-Methode gibt einen von EvtDeviceWdmIrpDispatch an das Framework gesendeten IRP zurück.

Syntax

NTSTATUS WdfDeviceWdmDispatchIrp(
  [in] WDFDEVICE  Device,
  [in] PIRP       Irp,
  [in] WDFCONTEXT DispatchContext
);

Parameter

[in] Device

Ein Handle für ein Framework-Geräteobjekt.

[in] Irp

Ein Zeiger auf eine IRP-Struktur.

[in] DispatchContext

Der Dispatchkontextparameter, den der Treiber im EvtDeviceWdmIrpDispatch-Rückruf empfangen hat.

Rückgabewert

Die WdfDeviceWdmDispatchIrp-Methode gibt einen NTSTATUS-Wert zurück, den das Framework oder der Treiber als Ergebnis der Verarbeitung des IRP bereitstellt. Der Treiber muss diesen Rückgabewert als Rückgabewert für die Rückruffunktion EvtDeviceWdmIrpDispatch verwenden, die WdfDeviceWdmDispatchIrp aufgerufen hat.

Eine Fehlerüberprüfung tritt auf, wenn ein KMDF-Treiber ein ungültiges Objekthandle bereitstellt. Wenn ein UMDF-Treiber ein ungültiges Handle bereitstellt, wird der Treiberhostprozess beendet.

Hinweise

Wenn Ihr Treiber eine EvtDeviceWdmIrpDispatch-Rückruffunktion bereitstellt, können Sie WdfDeviceWdmDispatchIrp aus der Rückruffunktion aufrufen, um den IRP zur Standardverarbeitung an das Framework zurückzugeben, anstatt es an eine bestimmte Warteschlange zu verteilen.

Weitere Informationen zum Angeben von Warteschlangen für IRPs beim Eintreffen finden Sie unter Dispatching IRPs to E/O Queues .

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.11
UMDF-Mindestversion 2.17
Kopfzeile wdfdevice.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf)

Weitere Informationen

EvtDeviceWdmIrpDispatch

WdfDeviceWdmDispatchIrpToIoQueue