BdaGetChangeState 函数 (bdasup.h)

BdaGetChangeState 函数返回 BDA 拓扑的当前更改状态。

语法

NTSTATUS BdaGetChangeState(
  [in]            PIRP              pIrp,
  [out, optional] PBDA_CHANGE_STATE pChangeState
);

参数

[in] pIrp

指向请求的 IRP 以获取当前更改状态。 BDA 微型驱动程序使用 KSMETHOD_BDA_GET_CHANGE_STATE 请求接收此 IRP。

[out, optional] pChangeState

指向接收 BDA 拓扑的当前更改状态的变量。 BDA 更改状态可以是 BDA_CHANGE_STATE 枚举类型的以下值之一:

价值 描述
BDA_CHANGES_COMPLETE BDA 拓扑更改已完成。
BDA_CHANGES_PENDING BDA 拓扑更改挂起。

返回值

返回STATUS_SUCCESS或适当的错误代码。

言论

BDA 微型驱动程序调用 BdaGetChangeState 函数,以在微型驱动程序从网络提供程序收到 KSMETHODSETID_BdaChangeSync 方法集的 KSMETHOD_BDA_GET_CHANGE_STATE 请求后检索 BDA 拓扑的当前更改状态。 BDA 微型驱动程序定义调度和筛选器自动化表,以便这些微型驱动程序直接调度 BdaGetChangeState 函数,或使用内部方法(KStrMethodHandler)截获此请求,然后调用 BdaGetChangeState 函数。 例如,截获此请求的 BDA 微型驱动程序可以从传递的 IRP 获取指向 BDA 筛选器的指针,以便他们可以:

  • 不仅检查挂起的拓扑更改,还检查筛选器上的挂起更改。

  • 返回 BDA 拓扑和 BDA 筛选器的当前更改状态。

有关详细信息,请参阅 定义自动化表更改 BDA 筛选器属性

要求

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

另请参阅

BDA_CHANGE_STATE

KSMETHODSETID_BdaChangeSync

KSMETHOD_BDA_GET_CHANGE_STATE

KStrMethodHandler