BdaMethodCreateTopology 函数 (bdasup.h)

项目
05/23/2024

BdaMethodCreateTopology 函数在筛选器的两个引脚之间创建模板拓扑。

语法

NTSTATUS BdaMethodCreateTopology(
  [in]       PIRP      pIrp,
  [in]       PKSMETHOD pKSMethod,
  [optional] PVOID     pvIgnored
);

参数

[in] pIrp

指向创建拓扑的请求的 IRP。 BDA 微型驱动程序通过 KSMETHOD_BDA_CREATE_TOPOLOGY 请求接收此 IRP。

[in] pKSMethod

指向描述方法请求的方法和请求类型的 KSMETHOD 结构。

[optional] pvIgnored

指向忽略的缓冲区。

返回值

返回STATUS_SUCCESS或相应的错误代码。

注解

在微型驱动程序收到来自网络提供程序的 KSMETHODSETID_BdaDeviceConfiguration 方法集的KSMETHOD_BDA_CREATE_TOPOLOGY请求后，BDA 微型驱动程序调用 BdaMethodCreateTopology 函数在两个筛选器引脚之间创建模板拓扑。大多数 BDA 微型驱动程序可以定义调度表和筛选自动化表，以便这些微型驱动程序直接调度 BdaMethodCreateTopology 函数。某些 BDA 微型驱动程序必须使用内部方法 (KStrMethodHandler) 截获此请求，而不是直接调度它。在调用 BdaMethodCreateTopology 之前，这些微型驱动程序必须从传递的 IRP 获取指向 BDA 筛选器的指针，以便它们可以使用筛选器来跟踪关联的引脚。然后，这些微型驱动程序可以在连接特定引脚类型时向硬件发送指令。有关详细信息，请参阅定义自动化表和配置 BDA 筛选器。

如果 BDA 微型驱动程序必须在两个筛选器引脚之间创建模板拓扑而不依赖于网络提供程序，则 BDA 微型驱动程序应调用 BdaCreateTopology 函数。