SdpCreateNodeTree-Funktion (sdplib.h)
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 |