WdfDeviceWdmDispatchIrp, fonction (wdfdevice.h)

  • Article

[S’applique à KMDF et UMDF]

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

Syntaxe

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

Paramètres

[in] Device

Handle pour un objet d’appareil d’infrastructure.

[in] Irp

Pointeur vers une structure IRP.

[in] DispatchContext

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

Valeur retournée

La méthode WdfDeviceWdmDispatchIrp retourne une valeur NTSTATUS que le framework ou le pilote fournit à la suite du traitement de l’IRP. Le pilote doit utiliser cette valeur de retour comme valeur de retour pour la fonction de rappel EvtDeviceWdmIrpDispatch qui a appelé WdfDeviceWdmDispatchIrp.

Un bogue case activée 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 s’arrête.

Remarques

Si votre pilote fournit une fonction de rappel EvtDeviceWdmIrpDispatch , vous pouvez appeler WdfDeviceWdmDispatchIrp à partir de la fonction de rappel pour renvoyer l’IRP au framework 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 irPs à mesure qu’ils arrivent, consultez Dispatching IRPs to I/O Queues.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.11
Version UMDF minimale 2.17
En-tête wdfdevice.h (inclure Wdf.h)
Bibliothèque Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
Règles de conformité DDI DriverCreate(kmdf)

Voir aussi

EvtDeviceWdmIrpDispatch

WdfDeviceWdmDispatchIrpToIoQueue