Fonction PcCompleteIrp (portcls.h)

Article
02/29/2024

La fonction PcCompleteIrp termine une IRP précédemment marquée comme étant en attente.

Syntaxe

PORTCLASSAPI NTSTATUS PcCompleteIrp(
  [in] PDEVICE_OBJECT pDeviceObject,
  [in] PIRP           pIrp,
  [in] NTSTATUS       ntStatus
);

Paramètres

[in] pDeviceObject

Pointeur vers l’objet d’appareil pour l’appareil. Ce paramètre doit pointer vers une structure système de type DEVICE_OBJECT.

[in] pIrp

Pointeur vers l’IRP à terminer

[in] ntStatus

Spécifie le status de l’IRP terminé. Consultez la liste des valeurs NTSTATUS définies dans le fichier d’en-tête ntstatus.h.

Valeur retournée

PcCompleteIrp retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié.

Remarques

PcCompleteIrp est utilisé lorsqu’un gestionnaire IRP retourne STATUS_PENDING et que l’IRP doit être effectué ultérieurement. Lorsque le pilote de l’adaptateur termine tout le traitement de l’IRP, il appelle PcCompleteIrp pour terminer l’IRP.

Le gestionnaire IRP ne doit pas appeler cette fonction. Le gestionnaire IRP d’un pilote d’adaptateur appelle plutôt PcDispatchIrp pour passer l’IRP au gestionnaire IRP du pilote système PortCls pour effectuer tout le traitement restant de l’IRP.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Le pilote système PortCls implémente la fonction PcCompleteIrp dans Microsoft Windows 98/Me et dans les systèmes d’exploitation Windows 2000 et ultérieur.
Plateforme cible	Universal
En-tête	portcls.h (include Portcls.h)
Bibliothèque	Portcls.lib
IRQL	<=DISPATCH_LEVEL

Voir aussi