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

See also

BTHDDI_SDP_NODE_INTERFACE

ExFreePool

SDP_NODE

SDP_TREE_ROOT_NODE

SdpFreeTree