SdpCreateNodeTree-Funktion (sdplib.h)

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

Syntax

PSDP_TREE_ROOT_NODE SdpCreateNodeTree(
  [in] ULONG tag
);

Parameter

[in] tag

Ein Profiltreiber, der 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 die Funktion nicht erfolgreich verläuft, wird NULL-zurückgegeben.

Bemerkungen

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

Wenn eine SDP-Struktur nicht mehr benötigt wird, sollte der Bluetooth-Profiltreiber sie zerstören, indem die SdpFreeTree-Funktion aufgerufen wird. SdpFreeTree gibt den Stammknoten und alle untergeordneten Knoten frei, die daran 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 über die BTHDDI_SDP_NODE_INTERFACE Struktur einen Zeiger auf diese Funktion abrufen.

Anforderungen

Siehe auch

BTHDDI_SDP_NODE_INTERFACE

ExFreePool-

SDP_NODE

SDP_TREE_ROOT_NODE

SdpFreeTree