SdpCreateNodeTree-Funktion (sdplib.h)

Artikel
03/05/2024

Die Bluetooth-Funktion SdpCreateNodeTree wird verwendet, um eine leere Stammstruktur SDP_TREE_ROOT_NODE zuzuordnen.

Syntax

PSDP_TREE_ROOT_NODE SdpCreateNodeTree(
  [in] ULONG tag
);

Parameter

[in] tag

Ein vom Profiltreiber definiertes Tag, das dem Knoten zugeordnet werden soll.

Rückgabewert

Bei erfolgreicher Ausführung gibt diese Funktion einen Zeiger auf die neu zugeordnete SDP_TREE_ROOT_NODE-Struktur zurück. Wenn dies nicht erfolgreich ist, gibt diese Funktion NULL zurück.

Hinweise

Das Aufrufen der SdpCreateNodeTree-Funktion ist der erste Schritt beim Erstellen einer SDP-Struktur. Nachdem ein Bluetooth-Profiltreiber mithilfe dieser Funktion einen Stammknoten zugeordnet hat, kann der Knoten durch Aufrufe anderer Funktionen aufgefüllt werden, auf die von der BTHDDI_SDP_NODE_INTERFACE Struktur.

Wenn eine SDP-Struktur nicht mehr benötigt wird, sollte der Bluetooth-Profiltreiber sie durch Aufrufen der SdpFreeTree-Funktion zerstören. SdpFreeTree gibt den Stammknoten und alle untergeordneten Knoten frei, die an ihn angefügt wurden. Einzelne SDP_NODE Strukturen können durch Aufrufen der ExFreePool-Treiberunterstützungsroutine freigegeben werden, solange sie nicht mehr Teil einer Struktur oder einer anderen Liste sind.

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

Anforderungen

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