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