通过

PcForwardIrpSynchronous 函数 （portcls.h）

  • 项目

IRP 处理程序使用 PcForwardIrpSynchronous 函数将即插即用 IRP 转发到 物理设备对象（PDO）。

语法

PORTCLASSAPI NTSTATUS PcForwardIrpSynchronous(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PIRP           Irp
);

参数

[in] DeviceObject

指向音频设备设备对象的指针。 此参数必须指向 DEVICE_OBJECT类型的系统结构。

[in] Irp

指向要转发的 IRP 的指针

返回值

如果调用成功，PcForwardIrpSynchronous 返回STATUS_SUCCESS。 否则，它将返回适当的错误代码。

言论

PcForwardIrpSynchronous 会导致下一个 PDO 接收 IRP 并阻止，直到物理设备驱动程序完成 IRP。 此时，PcForwardIrpSynchronous 取消阻止并返回到调用方。 调用方（IRP 处理程序）最终应返回状态为 STATUS_PENDING。 通常，调用此函数的任何 IRP 处理程序都必须在返回时指定作IRP_ACTION_FINISH。 任何其他作都会导致 IRP 再次转发到物理设备。

PcCompleteIrp 函数在 IRP 处理程序返回STATUS_PENDING时使用，并且稍后必须完成 IRP。

要求

要求 价值
最低支持的客户端 PortCls 系统驱动程序在 Microsoft Windows 98/Me 和 Windows 2000 及更高版本的作系统中实现 PcForwardIrpSynchronous 函数。
目标平台 普遍
标头 portcls.h （包括 Portcls.h）
库 Portcls.lib
IRQL PASSIVE_LEVEL

另请参阅

DEVICE_OBJECT

IRP

PcCompleteIrp