PcDispatchIrp, fonction (portcls.h)

La fonction PcDispatchIrp répartit un IRP vers le 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 de retour

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 des pointeurs vers des gestionnaires pour plusieurs adresses IP intégrées à l’objet 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).

Configuration requise

   
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

Voir aussi

DEVICE_OBJECT

IRP

PcInitializeAdapterDriver