PGETNEXTELEMENT-Rückruffunktion (bthsdpddi.h)

Die Bluetooth SdpGetNextElement-Funktion wird verwendet, um die Einträge in einem SDP-Datensatzdatenstrom zu durchlaufen.

Syntax

PGETNEXTELEMENT Pgetnextelement;

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

Parameter

Stream

Zeiger auf den SDP-Datensatzdatenstrom zum Durchlaufen.

StreamSize

Eine ganze Zahl ohne Vorzeichen, die die Größe des SDP-Datenstroms angibt.

CurrentElement

Ein Zeiger auf den aktuell ausgewählten Eintrag im SDP-Stream. Dieser Parameter kann einen NULL-Wert annehmen.

NextElement

Ein Zeiger auf eine Zeichenvariable ohne Vorzeichen, die die Adresse des nächsten Eintrags im SDP-Containerstream empfängt.

NextElementSize

Ein Zeiger auf eine ganzzahlige Variable ohne Vorzeichen, die die Größe des nächsten Eintrags im SDP-Containerstream empfängt.

Rückgabewert

Keine

Bemerkungen

Die SdpGetNextElement-Funktion arbeitet direkt für nicht analysierte Datenströme und erfordert nicht, dass der Aufrufer von einer Streamdarstellung des SDP-Datensatzes in eine strukturbasierte Darstellung konvertiert.

Die SdpGetNextElement-Funktion durchläuft die primären Einträge eines Containerstreams, durchläuft jedoch keine Untereinträge des angegebenen Eintrags. Um die Untereinträge zu durchlaufen, rufen Sie SdpGetNextElement iterativ mithilfe des NextElement-Parameters aus dem vorherigen Aufruf auf.

Wenn Sie diese Funktion aufrufen, wenn der CurrentElement-Parameter auf NULL festgelegt ist, wird der erste Eintrag im Containerstream zurückgegeben.

Bluetooth-Profiltreiber können einen Zeiger auf diese Funktion über die BTHDDI_SDP_PARSE_INTERFACE Struktur.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Versionen:_Supported in Windows Vista und höher.
Zielplattform	Desktop
Kopfzeile	bthsdpddi.h (include BthSdpddi.h)
IRQL	<= PASSIVE_LEVEL

Weitere Informationen

BTHDDI_SDP_PARSE_INTERFACE