BdaMethodCreateTopology 函数（bdasup.h）

项目
02/06/2025

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或适当的错误代码。

言论

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

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