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