PcCompleteIrp, fonction (portcls.h)
La fonction PcCompleteIrp termine un IRP qui a été précédemment marqué 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 appareil pour l’appareil. Ce paramètre doit pointer vers une structure système de type DEVICE_OBJECT.
[in] pIrp
Pointeur vers le IRP à terminer
[in] ntStatus
Spécifie l’état de l’IRP terminé. Consultez la liste des valeurs NTSTATUS définies dans le fichier d’en-tête ntstatus.h.
Valeur de retour
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 terminé 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. Au lieu de cela, le gestionnaire IRP d’un pilote d’adaptateur appelle PcDispatchIrp pour passer l’IRP au gestionnaire IRP du pilote système PortCls pour effectuer tout le traitement restant de l’IRP.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum 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érieurs. |
| plateforme cible | Universel |
| d’en-tête | portcls.h (include Portcls.h) |
| bibliothèque | Portcls.lib |
| IRQL | <=DISPATCH_LEVEL |