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

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

Синтаксис

PCONVERTTREETOSTREAM Pconverttreetostream;

NTSTATUS Pconverttreetostream(
  PSDP_TREE_ROOT_NODE Root,
  PUCHAR *Stream,
  PULONG Size,
  ULONG tag
)
{...}

Параметры

Root

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

Stream

Указатель на буфер, который получает преобразованный поток SDP.

Size

Адрес длинного целого числа без знака для получения длины преобразованного потока SDP.

tag

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

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

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

STATUS_SUCCESS

STATUS_INSUFFICIENT_RESOURCES

STATUS_INVALID_PARAMETER

Комментарии

Функция SdpConvertTreeToStream выполняет операцию, противоположную функции SdpConvertStreamToTree . Он создает полную собственную запись SDP из древовидной структуры Майкрософт. Разработчикам драйверов может быть удобнее создать запись SDP в виде дерева, а затем преобразовать ее в поток перед публикацией.

SdpConvertTreeToStream выделяет необходимую память для хранения потоковой версии записи SDP. Если память больше не требуется, вызывающий объект отвечает за освобождение памяти с помощью подпрограммы поддержки драйвера ExFreePool .

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

Требования

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

См. также раздел

BTHDDI_SDP_PARSE_INTERFACE

ExFreePool

SdpConvertStreamToTree