Fonction SdpCreateNodeTree (sdplib.h)

Article
02/29/2024

La fonction Bluetooth SdpCreateNodeTree permet d’allouer une structure de SDP_TREE_ROOT_NODE racine vide.

Syntaxe

PSDP_TREE_ROOT_NODE SdpCreateNodeTree(
  [in] ULONG tag
);

Paramètres

[in] tag

Balise définie par le pilote de profil à associer au nœud.

Valeur retournée

Si elle réussit, cette fonction retourne un pointeur vers la structure SDP_TREE_ROOT_NODE nouvellement allouée. Si elle échoue, cette fonction retourne NULL.

Remarques

L’appel de la fonction SdpCreateNodeTree est la première étape de la création d’une arborescence SDP. Une fois qu’un pilote de profil Bluetooth alloue un nœud racine à l’aide de cette fonction, le nœud peut être rempli à l’aide d’appels à d’autres fonctions pointées par le BTHDDI_SDP_NODE_INTERFACE structure.

Lorsqu’une arborescence SDP n’est plus nécessaire, le pilote de profil Bluetooth doit la détruire en appelant la fonction SdpFreeTree . SdpFreeTree libère le nœud racine et tous les nœuds enfants qui y ont été attachés. Les structures de SDP_NODE individuelles peuvent être libérées en appelant la routine de prise en charge du pilote ExFreePool tant qu’elles ne font plus partie d’une arborescence ou d’une autre liste.

Les pilotes de profil Bluetooth peuvent obtenir un pointeur vers cette fonction via la structure BTHDDI_SDP_NODE_INTERFACE.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Versions :_Supported dans Windows Vista et versions ultérieures.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	sdplib.h (inclure BthSdpddi.h)
IRQL	<= PASSIVE_LEVEL