bdaPropertyNodeDescriptors 函式 (bdasup.h)
BdaPropertyNodeDescriptors 函式會擷取範本拓撲中的節點清單。
語法
NTSTATUS BdaPropertyNodeDescriptors(
[in] PIRP pIrp,
[in] PKSPROPERTY pKSProperty,
[out, optional] BDANODE_DESCRIPTOR *pNodeDescriptorProperty
);
參數
[in] pIrp
指向要求以擷取節點清單的 IRP。 BDA 迷你驅動程式會透過 KSPROPERTY_BDA_NODE_DESCRIPTORS 要求接收此 IRP。
[in] pKSProperty
指向描述屬性要求之屬性和要求類型的 KSPROPERTY 結構。
[out, optional] pNodeDescriptorProperty
指向陣列，這個陣列會接收範本拓撲中節點的 GUID 清單。
傳回值
傳回STATUS_SUCCESS或適當的錯誤碼。
備註
BDA minidriver 會呼叫 BdaPropertyNodeDescriptors 函式，以在minidriver 收到從網路提供者設定之KSPROPSETID_BdaTopology屬性的KSPROPERTY_BDA_NODE_DESCRIPTORS要求之後，擷取節點清單。 大部分的 BDA 迷你驅動程式都可以定義分派和篩選自動化數據表，讓這些迷你驅動程式直接分派 BdaPropertyNodeDescriptors 函式，而不需使用內部 get-handler (KStrGetPropertyHandler) 攔截此要求。 如需詳細資訊，請參閱 定義自動化數據表 和 判斷 BDA 裝置拓撲 。
如需可在範本拓撲中建立的 BDA 節點清單，請參閱 BDA 節點類別 GUID。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Microsoft Windows XP 和更新版本的作業系統上使用。 只有當 Microsoft DirectX 9.0 和更新版本安裝在該平臺上時，Windows 2000 平臺才能使用此例程。 |
| 目標平台 | 桌面 |
| 標頭 | bdasup.h (包括 Bdasup.h) |
| 程式庫 | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |