Funzione SdpCreateNodeTree (sdplib.h)

Articolo
02/29/2024

La funzione Bluetooth SdpCreateNodeTree viene usata per allocare una struttura di SDP_TREE_ROOT_NODE radice vuota.

Sintassi

PSDP_TREE_ROOT_NODE SdpCreateNodeTree(
  [in] ULONG tag
);

Parametri

[in] tag

Un driver di profilo definito tag da associare al nodo.

Valore restituito

In caso di esito positivo, questa funzione restituisce un puntatore alla struttura di SDP_TREE_ROOT_NODE appena allocata. In caso contrario, questa funzione restituisce NULL.

Commenti

La chiamata alla funzione SdpCreateNodeTree è il primo passaggio nella creazione di un albero SDP. Dopo che un driver del profilo Bluetooth alloca un nodo radice usando questa funzione, il nodo può essere popolato usando chiamate ad altre funzioni puntate da BTHDDI_SDP_NODE_INTERFACE struttura.

Quando un albero SDP non è più necessario, il driver del profilo Bluetooth deve eliminarlo chiamando la funzione SdpFreeTree . SdpFreeTree libera il nodo radice e tutti i nodi figlio collegati. I singoli SDP_NODE strutture possono essere liberati chiamando la routine di supporto del driver ExFreePool finché non fanno 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.

Requisiti

Requisito	Valore
Client minimo supportato	Versioni:_Supported in Windows Vista e versioni successive.
Piattaforma di destinazione	Desktop
Intestazione	sdplib.h (includere BthSdpddi.h)
IRQL	<= PASSIVE_LEVEL