WdfDeviceWdmDispatchIrp-Funktion (wdfdevice.h)
[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) |