Funzione WdfDeviceWdmDispatchIrp (wdfdevice.h)

  • Articolo

[Si applica a KMDF e UMDF]

Il metodo WdfDeviceWdmDispatchIrp restituisce un IRP inviato al framework da EvtDeviceWdmIrpDispatch.

Sintassi

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

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

[in] Irp

Puntatore a una struttura IRP.

[in] DispatchContext

Parametro di contesto dispatch ricevuto dal driver nel callback EvtDeviceWdmIrpDispatch .

Valore restituito

Il metodo WdfDeviceWdmDispatchIrp restituisce un valore NTSTATUS fornito dal framework o dal driver in seguito all'elaborazione di IRP. Il driver deve usare questo valore restituito come valore restituito per la funzione di callback EvtDeviceWdmIrpDispatch che ha chiamato WdfDeviceWdmDispatchIrp.

Se un driver KMDF fornisce un handle di oggetto non valido, si verifica un controllo di bug. Se un driver UMDF fornisce un handle non valido, il processo host del driver termina.

Commenti

Se il driver fornisce una funzione di callback EvtDeviceWdmIrpDispatch , è possibile chiamare WdfDeviceWdmDispatchIrp dall'interno della funzione di callback per restituire l'IRP al framework per l'elaborazione predefinita invece di inviarla a una coda specifica.

Per altre informazioni sulla specifica delle code per i runtime di integrazione non appena arrivano, vedere Invio di indirizzi IRP alle code di I/O.

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.11
Versione UMDF minima 2.17
Intestazione wdfdevice.h (include Wdf.h)
Libreria Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
Regole di conformità DDI DriverCreate(kmdf)

Vedi anche

EvtDeviceWdmIrpDispatch

WdfDeviceWdmDispatchIrpToIoQueue