Функция 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.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Версии:_Supported в Windows Vista и более поздних версиях. |
| целевая платформа | Настольный |
| заголовка | sdplib.h (include BthSdpddi.h) |
| IRQL | <= PASSIVE_LEVEL |