Функция обратного вызова 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 |