Функция SdpCreateNodeTree (sdplib.h)
Функция 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 |