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