PcDispatchIrp, fonction (portcls.h)
La fonction PcDispatchIrp distribue un IRP au gestionnaire par défaut du pilote système PortCls.
Syntaxe
PORTCLASSAPI NTSTATUS PcDispatchIrp(
[in] PDEVICE_OBJECT pDeviceObject,
[in] PIRP pIrp
);
Paramètres
[in] pDeviceObject
Pointeur vers l’objet d’appareil. Ce paramètre doit pointer vers une structure système de type DEVICE_OBJECT.
[in] pIrp
Pointeur vers l’IRP à distribuer
Valeur retournée
PcDispatchIrp retourne STATUS_SUCCESS si l’appel a réussi. Sinon, il retourne un code d’erreur approprié.
Remarques
Dans le cadre de son processus d’initialisation, la fonction PcInitializeAdapterDriver charge les pointeurs vers les gestionnaires de plusieurs IIP dans l’objet pilote. Après l’appel à PcInitializeAdapterDriver, un pilote d’adaptateur peut choisir de remplacer un ou plusieurs des pointeurs du gestionnaire PortCls par des pointeurs vers ses propres gestionnaires IRP.
Si, après avoir reçu un IRP, le gestionnaire IRP du pilote d’adaptateur détermine que l’IRP doit être géré par le gestionnaire IRP PortCls à la place, le gestionnaire du pilote d’adaptateur appelle PcDispatchIrp pour transférer l’IRP au gestionnaire PortCls.
Pour obtenir un exemple de code, consultez l’exemple de pilote audio SB16 dans microsoft Windows Driver Kit (WDK).
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Le pilote système PortCls implémente la fonction PcDispatchIrp dans Microsoft Windows 98/Me et dans les systèmes d’exploitation Windows 2000 et ultérieurs. |
| Plateforme cible | Universal |
| En-tête | portcls.h |
| Bibliothèque | Portcls.lib |
| IRQL | PASSIVE_LEVEL |