PcDispatchIrp 函数 (portcls.h)

PcDispatchIrp 函数将 IRP 调度到 PortCls 系统驱动程序的默认处理程序。

语法

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

参数

[in] pDeviceObject

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

[in] pIrp

指向要调度的 IRP 的指针

返回值

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

言论

作为初始化过程的一部分,PcInitializeAdapterDriver 函数将指向多个 IRP 处理程序的指针加载到驱动程序对象中。 调用 PcInitializeAdapterDriver后,适配器驱动程序可以选择使用指向其自己的 IRP 处理程序的指针覆盖一个或多个 PortCls 处理程序指针。

如果在收到 IRP 后,适配器驱动程序的 IRP 处理程序确定 IRP 应由 PortCls IRP 处理程序处理,适配器驱动程序的处理程序会调用 PcDispatchIrp 将 IRP 转发到 PortCls 处理程序。

有关代码示例,请参阅 Microsoft Windows 驱动程序工具包(WDK)中的 SB16 示例音频驱动程序。

要求

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

另请参阅

DEVICE_OBJECT

IRP

PcInitializeAdapterDriver