PcCompleteIrp-Funktion (portcls.h)

Artikel
02/29/2024

Die PcCompleteIrp-Funktion schließt eine IRP ab, die zuvor als ausstehend gekennzeichnet war.

Syntax

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

Parameter

[in] pDeviceObject

Zeiger auf das Geräteobjekt für das Gerät. Dieser Parameter muss auf eine Systemstruktur vom Typ DEVICE_OBJECT verweisen.

[in] pIrp

Zeiger auf den IRP , der abgeschlossen werden soll

[in] ntStatus

Gibt die status des abgeschlossenen IRP an. Sehen Sie sich die Liste der NTSTATUS-Werte an, die in der Headerdatei ntstatus.h definiert sind.

Rückgabewert

PcCompleteIrp gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben.

Hinweise

PcCompleteIrp wird verwendet, wenn ein IRP-Handler STATUS_PENDING zurückgibt und der IRP später abgeschlossen werden muss. Wenn der Adaptertreiber die gesamte Verarbeitung des IRP abgeschlossen hat, ruft er PcCompleteIrp auf, um die IRP abzuschließen.

Der IRP-Handler sollte diese Funktion nicht aufrufen. Der IRP-Handler eines Adaptertreibers ruft stattdessen PcDispatchIrp auf, um das IRP an den IRP-Handler des PortCls-Systemtreibers zu übergeben, um die gesamte verbleibende Verarbeitung des IRP auszuführen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Der PortCls-Systemtreiber implementiert die PcCompleteIrp-Funktion in Microsoft Windows 98/Me und in Windows 2000 und höheren Betriebssystemen.
Zielplattform	Universell
Header	portcls.h (include Portcls.h)
Bibliothek	Portcls.lib
IRQL	<=DISPATCH_LEVEL

Weitere Informationen