SdpCreateNodeTree, fonction (sdplib.h)
La fonction SdpCreateNodeTree Bluetooth est utilisée pour 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 un pilote de profil à associer au nœud.
Valeur de retour
Si elle réussit, cette fonction retourne un pointeur vers la structure SDP_TREE_ROOT_NODE nouvellement allouée. Si elle ne réussit pas, 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 structure BTHDDI_SDP_NODE_INTERFACE.
Lorsqu’une arborescence SDP n’est plus nécessaire, le pilote de profil Bluetooth doit le 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 le ExFreePool pilote prennent en charge la routine 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Versions :_Supported dans Windows Vista et versions ultérieures. |
| plateforme cible | Bureau |
| d’en-tête | sdplib.h (include BthSdpddi.h) |
| IRQL | <= PASSIVE_LEVEL |