BdaMethodCreateTopology 函式 (bdasup.h)

發行項
05/23/2024

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) ，而不是直接分派。這些迷你驅動程式必須在呼叫 BdaMethodCreateTopology 之前，先從傳遞的 IRP 取得 BDA 篩選的指標，才能使用篩選來追蹤相關聯的針腳。這些迷你驅動程式接著可以在連接特定針腳類型時，將指示傳送至硬體。如需詳細資訊，請參閱定義自動化數據表和設定 BDA 篩選。

如果 BDA 迷你驅動程式必須在兩個篩選針腳之間建立範本拓撲，而不需要依賴網路提供者，BDA 迷你驅動程式應該呼叫 BdaCreateTopology 函式。