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 de l’appareil. Ce paramètre doit pointer vers une structure système de type DEVICE_OBJECT.
[in] pIrp
Pointeur vers le IRP à distribuer
Valeur de retour
PcDispatchIrp retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié.
Remarques
Dans le cadre de son processus d’initialisation, la fonction PcInitializeAdapterDriver charge des pointeurs vers des gestionnaires pour plusieurs IRPs dans l’objet du pilote. Après l’appel à PcInitializeAdapterDriver, un pilote d’adaptateur peut choisir de remplacer un ou plusieurs pointeurs du gestionnaire PortCls avec 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 le Kit de pilotes Microsoft Windows (WDK).
Exigences
| Exigence | Valeur |
|---|---|
| client minimum 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 versions ultérieures. |
| plateforme cible | Universel |
| d’en-tête | portcls.h |
| bibliothèque | Portcls.lib |
| IRQL | PASSIVE_LEVEL |