pcCompleteIrp 函数 (portcls.h)
PcCompleteIrp 函数完成以前标记为挂起的 IRP。
语法
PORTCLASSAPI NTSTATUS PcCompleteIrp(
[in] PDEVICE_OBJECT pDeviceObject,
[in] PIRP pIrp,
[in] NTSTATUS ntStatus
);
参数
[in] pDeviceObject
指向设备的设备对象的指针。 此参数必须指向 DEVICE_OBJECT 类型的系统结构。
[in] pIrp
指向要完成的 IRP 的指针
[in] ntStatus
指定已完成的 IRP 的状态。 请参阅头文件 ntstatus.h 中定义的 NTSTATUS 值列表。
返回值
如果调用成功,PcCompleteIrp 将返回STATUS_SUCCESS。 否则,它将返回相应的错误代码。
注解
当 IRP 处理程序返回STATUS_PENDING且 IRP 稍后必须完成时,将使用 PcCompleteIrp。 适配器驱动程序完成 IRP 的所有处理后,它会调用 PcCompleteIrp 来完成 IRP。
IRP 处理程序不应调用此函数。 适配器驱动程序的 IRP 处理程序改为调用 PcDispatchIrp ,将 IRP 传递到 PortCls 系统驱动程序的 IRP 处理程序,以执行 IRP 的所有剩余处理。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | PortCls 系统驱动程序在 Microsoft Windows 98/Me 和 Windows 2000 及更高版本的操作系统中实现 PcCompleteIrp 函数。 |
目标平台 | 通用 |
标头 | portcls.h (包括 Portcls.h) |
Library | Portcls.lib |
IRQL | <=DISPATCH_LEVEL |