Função SdpCreateNodeTree (sdplib.h)
A função SdpCreateNodeTree Bluetooth é 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ó.
Valor de retorno
Se bem-sucedida, essa função retornará um ponteiro para a estrutura de SDP_TREE_ROOT_NODE recém-alocada. Se não tiver êxito, essa função retornará NULL.
Observações
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. 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 de do 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 |
|---|---|
| de cliente com suporte mínimo | Versões:_Supported no Windows Vista e posterior. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | sdplib.h (include BthSdpddi.h) |
| IRQL | <= PASSIVE_LEVEL |