SdpCreateNodeUInt8 - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// sdplib.h

PSDP_NODE SdpCreateNodeUInt8(
  [in] UCHAR ucVal,
  [in] ULONG tag
);
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nf-sdplib-sdpcreatenodeuint8)

SdpCreateNodeUInt8 function

Description

The Bluetooth SdpCreateNodeUInt8 function is used to allocate and initialize an SDP_NODE structure to an unsigned 8-bit integer type.

Parameters

ucVal [in]

The unsigned 8-bit integer value that is used to initialize the SDP_NODE structure.

tag [in]

A profile driver defined tag to associate with the node.

Return value

If successful, this function returns a pointer to the newly allocated SDP_NODE structure. If not successful, this function returns NULL.

Remarks

After the SdpCreateNodeUInt8 function allocates an SDP_NODE structure, it initializes the structure in the following ways.

It ensures that the SDP_NODE structure's data type and data size fields are set appropriately.

It ensures that the pointer members of the associated SDP_NODE_HEADER structure are initialized to point to the node itself. This creates a valid list with only one element.

It ensures that the value parameter passed to the function is copied to the appropriate element of the SDP_NODE_DATA union that is associated with the SDP_NODE structure.

The data associated with the SdpCreateNodeUInt8 function is copied into the node, and the original data can be freed at any time.

Bluetooth profile drivers can obtain a pointer to this function through the BTHDDI_SDP_NODE_INTERFACE structure.

See also

BTHDDI_SDP_NODE_INTERFACE

SDP_NODE

SDP_NODE_DATA

SDP_NODE_HEADER