Fonction SdpCreateNodeUrl (sdplib.h)
La fonction Bluetooth SdpCreateNodeUrl permet d’allouer et d’initialiser une structure SDP_NODE à un type d’URL.
Syntaxe
PSDP_NODE SdpCreateNodeUrl(
[in] PCHAR url,
ULONG urlLength,
[in] ULONG tag
);
Paramètres
[in] url
Pointeur vers la valeur d’URL utilisée pour initialiser la structure SDP_NODE.
urlLength
Valeur entière longue non signée qui contient la longueur de l’URL.
[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_NODE nouvellement allouée. Si elle échoue, cette fonction retourne NULL.
Remarques
Une fois que la fonction SdpCreateNodeUrl alloue une structure SDP_NODE , elle initialise la structure de la manière suivante.
Il garantit que le type de données et les champs de taille de données de la structure SDP_NODE sont correctement définis.
Il garantit que les membres de pointeur de la structure SDP_NODE_HEADER associée sont initialisés pour pointer vers le nœud lui-même. Cela crée une liste valide avec un seul élément.
Il garantit que le paramètre value passé à la fonction est copié dans l’élément approprié de l’union SDP_NODE_DATA associé à la structure SDP_NODE.
Les données associées à la fonction SdpCreateNodeUrl sont copiées dans le nœud et les données d’origine peuvent être libérées à tout moment.
Les pilotes de profil Bluetooth peuvent obtenir un pointeur vers cette fonction via le BTHDDI_SDP_NODE_INTERFACE structure.
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 |