bdaPropertyTemplateConnections 函式 (bdasup.h)

發行項
02/22/2024

BdaPropertyTemplateConnections 函式會擷取連線清單，描述釘選類型和節點類型在範本拓撲中的連線方式。

語法

NTSTATUS BdaPropertyTemplateConnections(
  [in]            PIRP                   pIrp,
  [in]            PKSPROPERTY            pKSProperty,
  [out, optional] PKSTOPOLOGY_CONNECTION pConnectionProperty
);

參數

[in] pIrp

指向要擷取連線清單之要求的 IRP。 BDA 迷你驅動程式會透過 KSPROPERTY_BDA_TEMPLATE_CONNECTIONS 要求接收此 IRP。

[in] pKSProperty

指向描述屬性要求之屬性和要求類型的 KSPROPERTY 結構。

[out, optional] pConnectionProperty

指向接收描述範本拓撲中連接之KSTOPOLOGY_CONNECTION 結構的陣列。

傳回值

傳回STATUS_SUCCESS或適當的錯誤碼。

備註

BDA 迷你驅動程式會呼叫 BdaPropertyTemplateConnections 函式，以擷取迷你驅動程式從網路提供者所設定KSPROPSETID_BdaTopology屬性的KSPROPERTY_BDA_TEMPLATE_CONNECTIONS要求之後，擷取範本聯機清單。大部分的 BDA 迷你驅動程式都可以定義分派和篩選自動化數據表，讓這些迷你驅動程式直接分派 BdaPropertyTemplateConnections 函式，而不需使用內部 get-handler (KStrGetPropertyHandler) 攔截此要求。如需詳細資訊，請參閱定義自動化數據表和判斷 BDA 裝置拓撲。

當 BDA 迷你驅動程式在 BdaCreateFilterFactory 和 BdaInitFilter 函式呼叫中傳遞 BDA 篩選範本 (BDA_FILTER_TEMPLATE) 時，BDA 迷你驅動程式會在KSTOPOLOGY_CONNECTION結構數位中提供 BDA 支援連結庫的聯機清單。此陣列是節點與針腳類型之間所有可能連線的表示法，可在篩選內或篩選條件與相鄰篩選之間建立。 BdaPropertyTemplateConnections 函式會傳回此數位。