Функция SdpCreateNodeTree (sdplib.h)

Статья
02/27/2024

Функция Bluetooth SdpCreateNodeTree используется для выделения пустой корневой SDP_TREE_ROOT_NODE структуры.

Синтаксис

PSDP_TREE_ROOT_NODE SdpCreateNodeTree(
  [in] ULONG tag
);

Параметры

[in] tag

Определенный тег драйвера профиля для связывания с узлом.

Возвращаемое значение

В случае успешного выполнения эта функция возвращает указатель на только что выделенную SDP_TREE_ROOT_NODE структуру. Если это не удалось, эта функция возвращает значение NULL.

Вызов функции SdpCreateNodeTree является первым шагом в создании дерева SDP. После того как драйвер профиля Bluetooth выделяет корневой узел с помощью этой функции, узел можно заполнить с помощью вызовов других функций, на которые указывает структура BTHDDI_SDP_NODE_INTERFACE .

Если дерево SDP больше не требуется, драйвер профиля Bluetooth должен уничтожить его, вызвав функцию SdpFreeTree . SdpFreeTree освобождает корневой узел и все дочерние узлы, подключенные к нему. Отдельные структуры SDP_NODE можно освободить, вызвав подпрограмму поддержки драйвера ExFreePool , если они больше не являются частью дерева или другого списка.

Драйверы профилей Bluetooth могут получить указатель на эту функцию через структуру BTHDDI_SDP_NODE_INTERFACE.

Требования

Требование	Значение
Минимальная версия клиента	Versions:_Supported в Windows Vista и более поздних версий.
Целевая платформа	Персональный компьютер
Верхняя часть	sdplib.h (включая BthSdpddi.h)
IRQL	<= PASSIVE_LEVEL