PcCompleteIrp-Funktion (portcls.h)
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 |