Функция обратного вызова PCONVERTSTREAMTOTREE (bthsdpddi.h)

Статья
04/18/2024

Функция Bluetooth SdpConvertStreamToTree используется для создания собственного представления записи SDP на основе дерева Майкрософт, оставляя исходное представление на основе потока без изменений.

Синтаксис

PCONVERTSTREAMTOTREE Pconvertstreamtotree;

NTSTATUS Pconvertstreamtotree(
  PUCHAR Stream,
  ULONG Size,
  PSDP_TREE_ROOT_NODE *Node,
  ULONG tag
)
{...}

Параметры

Stream

Поток записей SDP для преобразования в представление на основе дерева.

Size

Размер исходного потока записей SDP.

Node

Указатель на структуру SDP_TREE_ROOT_NODE , которая служит корнем представления записи SDP на основе дерева SDP.

tag

Указывает 4-байтовой тег пула , однозначно определяющий драйвер, который выделяет память. Дополнительные сведения о тегах пула см. в разделе ExAllocatePoolWithTag.

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

Возможные возвращаемые значения:

STATUS_SUCCESS
STATUS_INSUFFICIENT_RESOURCES
STATUS_INVALID_PARAMETER

Древовидное представление записи SDP, которое является результатом вызова функции SdpConvertStreamToTree , состоит из ряда взаимосвязанных SDP_NODE структур. Корневой узел содержит одну структуру SDP_TREE_ROOT_NODE.

Каждая структура SDP_NODE содержит SDP_NODE_HEADER структуру и SDP_NODE_DATA объединение. Заголовок указывает тип данных, а драйверы профилей Bluetooth могут обращаться к ссылкам на одноранговые структуры SDP_NODE через структуру системы LIST_ENTRY . Оценивая и Node.hdr.Link.Blink, Node.hdr.Link.Flinkдрайверы могут получить адреса одноранговых узлов в дереве. Помните, что указатели в структуре LIST_ENTRY содержат адреса других LIST_ENTRY структур и что драйверы Bluetooth должны использовать макрос диспетчера памяти CONTAINING_RECORD для извлечения адреса содержащей записи узла.

С помощью последовательностиSDP_NODE_DATA объединения и альтернативных членов драйверы профиля могут обращаться к подэлестам дерева. Если тип данных узла — SDP_TYPE_SEQUENCE, узел является последовательностью SDP. Если тип данных узла SDP_TYPE_ALTERNATIVE, узел является альтернативной последовательностью SDP. В первом случае член последовательности является допустимым и содержит сведения, необходимые для доступа к части дерева, соответствующей последовательности. Во втором случае альтернативный элемент является допустимым и содержит сведения, необходимые для доступа к части дерева, соответствующей альтернативе. Последовательность или альтернативный член при использовании содержит дополнительную структуру SDP_NODE_HEADER, которая используется для доступа к узлам в последовательности или альтернативе. Например, node->u.sequence.Flinkуказывает на LIST_ENTRY структуру первого члена последовательности, представленного узлом.

Остальные члены объединения данных содержат фактические данные, извлеченные из потока SDP. Для большинства типов данные непосредственно присутствуют в структуре. Однако для строк и URL-адресов предоставляется указатель на фактические данные. Память для строки выделяется вызовом функции SdpConvertStreamToTree и должна быть освобождена путем вызова функции SdpFreeTree для дерева.

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

Требования

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