Funzione SdpCreateNodeTree (sdplib.h)
La funzione Bluetooth SdpCreateNodeTree viene usata per allocare una struttura SDP_TREE_ROOT_NODE radice vuota.
Sintassi
PSDP_TREE_ROOT_NODE SdpCreateNodeTree(
[in] ULONG tag
);
Parametri
[in] tag
Tag definito dal driver del profilo da associare al nodo.
Valore restituito
In caso di esito positivo, questa funzione restituisce un puntatore alla struttura SDP_TREE_ROOT_NODE appena allocata. In caso di esito negativo, questa funzione restituisce NULL.
Osservazioni
La chiamata alla funzione SdpCreateNodeTree è il primo passaggio per la creazione di un albero SDP. Dopo che un driver del profilo Bluetooth alloca un nodo radice usando questa funzione, il nodo può essere popolato tramite chiamate ad altre funzioni a cui punta il BTHDDI_SDP_NODE_INTERFACE struttura.
Quando un albero SDP non è più necessario, il driver del profilo Bluetooth deve distruggerlo chiamando la funzione SdpFreeTree. SdpFreeTree libera il nodo radice e tutti i nodi figlio collegati. Le singole strutture di SDP_NODE possono essere liberate chiamando la routine di supporto driver di exFreePool purché non facciano più parte di un albero o di un altro elenco.
I driver del profilo Bluetooth possono ottenere un puntatore a questa funzione tramite la struttura BTHDDI_SDP_NODE_INTERFACE.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Versioni:_Supported in Windows Vista e versioni successive. |
| piattaforma di destinazione | Desktop |
| intestazione | sdplib.h (include BthSdpddi.h) |
| IRQL | <= PASSIVE_LEVEL |