WdfDeviceWdmDispatchIrp, fonction (wdfdevice.h)

[S’applique à KMDF et UMDF]

La méthode WdfDeviceWdmDispatchIrp retourne un IRP distribué dans l’infrastructure à partir de EvtDeviceWdmIrpDispatch.

Syntaxe

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

Paramètres

[in] Device

Handle vers un objet d’appareil framework.

[in] Irp

Pointeur vers une structure IRP.

[in] DispatchContext

Paramètre de contexte de répartition reçu dans EvtDeviceWdmIrpDispatch rappel.

Valeur de retour

La méthode WdfDeviceWdmDispatchIrp retourne une valeur NTSTATUS que l’infrastructure ou le pilote fournit en raison du traitement de l’IRP. Le pilote doit utiliser cette valeur de retour comme valeur de retour pour la fonction de rappel EvtDeviceWdmIrpDispatch fonction de rappel appelée WdfDeviceWdmDispatchIrp.

Une vérification de bogue se produit si un pilote KMDF fournit un handle d’objet non valide. Si un pilote UMDF fournit un handle non valide, le processus hôte du pilote se termine.

Remarques

Si votre pilote fournit une fonction de rappel EvtDeviceWdmIrpDispatch, vous pouvez appeler WdfDeviceWdmDispatchIrp à partir de la fonction de rappel pour renvoyer l’IRP à l’infrastructure pour le traitement par défaut au lieu de le distribuer à une file d’attente spécifique.

Pour plus d’informations sur la spécification de files d’attente pour les fournisseurs d’intégration à mesure qu’ils arrivent, consultez Dispatching IRPs to I/O Queues.

Spécifications

Voir aussi

EvtDeviceWdmIrpDispatch

WdfDeviceWdmDispatchIrpToIoQueue