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列舉型 別的值之一:
值 | Description |
---|---|
BDA_CHANGES_COMPLETE | BDA 拓撲變更已完成。 |
BDA_CHANGES_PENDING | BDA 拓撲變更擱置中。 |
傳回值
傳回STATUS_SUCCESS或適當的錯誤碼。
備註
BDA minidriver 會呼叫 BdaGetChangeState 函式,以在minidriver收到從網路提供者設定之KSMETHODSETID_BdaChangeSync方法的KSMETHOD_BDA_GET_CHANGE_STATE要求之後,擷取 BDA 拓撲的目前變更狀態。 BDA minidrivers 會定義分派和篩選自動化數據表,讓這些迷你驅動程式直接分派 BdaGetChangeState 函式,或使用 KStrMethodHandler) 的內部 (方法攔截此要求,然後呼叫 BdaGetChangeState 函式。 例如,攔截此要求的 BDA 迷你驅動程式可以從傳遞的 IRP 取得 BDA 篩選條件的指標,讓他們可以:
不僅檢查擱置的拓撲變更,也檢查篩選條件上的擱置變更。
傳回 BDA 拓撲和 BDA 篩選條件的目前變更狀態。
如需詳細資訊,請參閱 定義自動化數據表 和 變更 BDA 篩選屬性 。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | bdasup.h (包括 Bdasup.h) |
程式庫 | Bdasup.lib |
IRQL | PASSIVE_LEVEL |