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 处理程序确定应由 PortCls IRP 处理程序处理 IRP，则适配器驱动程序的处理程序调用 PcDispatchIrp 以将 IRP 转发到 PortCls 处理程序。

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

要求

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

另请参阅

DEVICE_OBJECT

IRP

PcInitializeAdapterDriver