BdaMethodCreateTopology 函数 (bdasup.h)

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 之前,这些 mindriver 必须从传递的 IRP 获取指向 BDA 筛选器的指针,以便他们可以使用筛选器来跟踪关联的引脚。 然后,这些微型驱动程序可以在连接特定引脚类型时向硬件发送指令。 有关详细信息 ,请参阅定义自动化表配置 BDA 筛选器

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

要求

要求
目标平台 桌面
标头 bdasup.h (包括 Bdasup.h)
Library Bdasup.lib
IRQL PASSIVE_LEVEL

另请参阅

BdaCreateTopology

KSMETHOD

KSMETHODSETID_BdaDeviceConfiguration

KSMETHOD_BDA_CREATE_TOPOLOGY

KStrMethodHandler