SdpCreateNodeTree 函数 (sdplib.h)

蓝牙 SdpCreateNodeTree 函数用于分配空根 SDP_TREE_ROOT_NODE 结构。

语法

PSDP_TREE_ROOT_NODE SdpCreateNodeTree(
  [in] ULONG tag
);

[in] tag

要与节点关联的配置文件驱动程序定义的标记。

如果成功，此函数返回指向新分配的SDP_TREE_ROOT_NODE结构的指针。如果未成功，此函数将返回 NULL。

调用 SdpCreateNodeTree 函数是生成 SDP 树的第一步。蓝牙配置文件驱动程序使用此函数分配根节点后，可以使用对指向的其他函数的调用来填充节点 BTHDDI_SDP_NODE_INTERFACE 结构。

当不再需要 SDP 树时，蓝牙配置文件驱动程序应通过调用 SdpFreeTree 函数来销毁它。 SdpFreeTree 释放根节点和已附加到该根节点的所有子节点。可以通过调用 ExFreePool 驱动程序支持例程来释放单个SDP_NODE结构，只要它们不再是树或其他列表的一部分。

蓝牙配置文件驱动程序可以通过BTHDDI_SDP_NODE_INTERFACE结构获取指向此函数的指针。

要求	值
最低受支持的客户端	版本：Windows Vista 及更高版本中的 _Supported。
目标平台	桌面
标头	sdplib.h (包括 BthSdpddi.h)
IRQL	<= PASSIVE_LEVEL