Função SdpCreateNodeTree (sdplib.h)
A função Bluetooth SdpCreateNodeTree é usada para alocar uma estrutura de SDP_TREE_ROOT_NODE raiz vazia.
Sintaxe
PSDP_TREE_ROOT_NODE SdpCreateNodeTree(
[in] ULONG tag
);
Parâmetros
[in] tag
Uma marca definida pelo driver de perfil a ser associada ao nó.
Retornar valor
Se tiver êxito, essa função retornará um ponteiro para a estrutura de SDP_TREE_ROOT_NODE recém-alocada. Se não for bem-sucedida, essa função retornará NULL.
Comentários
Chamar a função SdpCreateNodeTree é a primeira etapa na criação de uma árvore SDP. Depois que um driver de perfil Bluetooth aloca um nó raiz usando essa função, o nó pode ser preenchido usando chamadas para outras funções apontadas pelo BTHDDI_SDP_NODE_INTERFACE estrutura.
Quando uma árvore SDP não é mais necessária, o driver de perfil Bluetooth deve destruí-la chamando a função SdpFreeTree . O SdpFreeTree libera o nó raiz e todos os nós filho que foram anexados a ele. Estruturas de SDP_NODE individuais podem ser liberadas chamando a rotina de suporte do driver ExFreePool , desde que não façam mais parte de uma árvore ou outra lista.
Os drivers de perfil Bluetooth podem obter um ponteiro para essa função por meio da estrutura BTHDDI_SDP_NODE_INTERFACE.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Versões:_Supported no Windows Vista e posteriores. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | sdplib.h (inclua BthSdpddi.h) |
| IRQL | <= PASSIVE_LEVEL |