SdpCreateNodeTree function (sdplib.h)
The Bluetooth SdpCreateNodeTree function is used to allocate an empty root SDP_TREE_ROOT_NODE structure.
Syntax
PSDP_TREE_ROOT_NODE SdpCreateNodeTree(
[in] ULONG tag
);
Parameters
[in] tag
A profile driver defined tag to associate with the node.
Return value
If successful, this function returns a pointer to the newly allocated SDP_TREE_ROOT_NODE structure. If not successful, this function returns NULL.
Remarks
Calling the SdpCreateNodeTree function is the first step in building an SDP tree. After a Bluetooth profile driver allocates a root node by using this function, the node can be populated by using calls to other functions pointed to by the BTHDDI_SDP_NODE_INTERFACE structure.
When an SDP tree is no longer needed, the Bluetooth profile driver should destroy it by calling the SdpFreeTree function. SdpFreeTree frees the root node and all child nodes that have been attached to it. Individual SDP_NODE structures can be freed by calling the ExFreePool driver support routine as long as they are no longer part of a tree or other list.
Bluetooth profile drivers can obtain a pointer to this function through the BTHDDI_SDP_NODE_INTERFACE structure.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Versions:_Supported in Windows Vista, and later. |
| Target Platform | Desktop |
| Header | sdplib.h (include BthSdpddi.h) |
| IRQL | <= PASSIVE_LEVEL |