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

注解

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

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

要求

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

另请参阅

BdaCreateTopology

KSMETHOD

KSMETHODSETID_BdaDeviceConfiguration

KSMETHOD_BDA_CREATE_TOPOLOGY

KStrMethodHandler