PcDispatchIrp, fonction (portcls.h)

  • Article

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

Voir aussi

DEVICE_OBJECT

IRP

PcInitializeAdapterDriver