bdaStartChanges 函式 (bdasup.h)

發行項
02/25/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 函式會導致任何先前要求的拓撲變更尚未被忽略。