PGETNEXTELEMENT callback function (bthsdpddi.h)

Article
04/01/2021

The Bluetooth SdpGetNextElement function is used to iterate through the entries found in an SDP record stream.

Syntax

PGETNEXTELEMENT Pgetnextelement;

void Pgetnextelement(
  PUCHAR Stream,
  ULONG StreamSize,
  PUCHAR CurrentElement,
  PUCHAR *NextElement,
  PULONG NextElementSize
)
{...}

Parameters

Stream

Pointer to the SDP record stream to iterate through.

StreamSize

An unsigned long integer that indicates the size of the SDP stream.

CurrentElement

A pointer to the currently selected entry in the SDP stream. This parameter can take a NULL value.

NextElement

A pointer to an unsigned character variable that receives the address of the next entry in the SDP container stream.

NextElementSize

A pointer to an unsigned long integer variable that receives the size of the next entry in the SDP container stream.

Return value

None

Remarks

The SdpGetNextElement function operates directly on unparsed streams and does not require the caller to convert from a stream representation of the SDP record to a tree-based representation.

The SdpGetNextElement function iterates through the primary entries of a container stream but does not iterate through any sub-entries of the given entry. To iterate through the sub-entries call SdpGetNextElement iteratively using the NextElement parameter obtained from the previous call.

Calling this function with the CurrentElement parameter set to NULL returns the first entry in the container stream.

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

Requirements

Requirement	Value
Minimum supported client	Versions:_Supported in Windows Vista, and later.
Target Platform	Desktop
Header	bthsdpddi.h (include BthSdpddi.h)
IRQL	<= PASSIVE_LEVEL