BdaStartChanges 函数 (bdasup.h)

项目
02/22/2024

BdaStartChanges 函数启动新 BDA 拓扑更改的设置。

语法

NTSTATUS BdaStartChanges(
  [in] PIRP pIrp
);

参数

[in] pIrp

指向请求的 IRP 以启动更改。 BDA 微型驱动程序通过 KSMETHOD_BDA_START_CHANGES 请求接收此 IRP。

返回值

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

注解

BDA 微型驱动程序调用 BdaStartChanges 函数，以在微型驱动程序从网络提供程序接收KSMETHODSETID_BdaChangeSync方法集的KSMETHOD_BDA_START_CHANGES 请求后启动新 BDA 拓扑更改的设置。 BDA 微型驱动程序定义调度表和筛选器自动化表，以便这些微型驱动程序可以直接调度 BdaStartChanges 函数，或使用内部方法截获此请求 (KStrMethodHandler) ，然后调用 BdaStartChanges 函数。例如，截获此请求的 BDA 微型驱动程序可以从传递的 IRP 获取指向 BDA 筛选器的指针，以便他们可以随后将挂起的筛选器资源重置为新要求，并将筛选器的更改状态设置为BDA_CHANGES_COMPLETE。有关详细信息，请参阅定义自动化表和更改 BDA 筛选器属性。

调用 BdaStartChanges 函数会导致之前请求的任何尚未提交的拓扑更改被忽略。