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

Статья
02/06/2025

Функция Bluetooth SdpGetNextElement используется для итерации записей, найденных в потоке записей SDP.

Синтаксис

PGETNEXTELEMENT Pgetnextelement;

void Pgetnextelement(
  PUCHAR Stream,
  ULONG StreamSize,
  PUCHAR CurrentElement,
  PUCHAR *NextElement,
  PULONG NextElementSize
)
{...}

Параметры

Stream

Указатель на поток записей SDP для итерации.

StreamSize

Целое число без знака, указывающее размер потока SDP.

CurrentElement

Указатель на выбранную запись в потоке SDP. Этот параметр может принимать значение NULL.

NextElement

Указатель на переменную без знака, которая получает адрес следующей записи в потоке контейнеров SDP.

NextElementSize

Указатель на незначимую длинную целочисленную переменную, которая получает размер следующей записи в потоке контейнеров SDP.

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

Никакой

Замечания

Функция SdpGetNextElement работает непосредственно на неподпарированных потоках и не требует преобразования вызывающего объекта из представления записи SDP в представление на основе дерева.

Функция SdpGetNextElement выполняет итерацию по основным записям потока контейнера, но не выполняет итерацию с помощью каких-либо вложенных записей заданной записи. Для итерации с помощью вызова вложенных записей SdpGetNextElement с помощью параметра NextElement, полученного из предыдущего вызова.

Вызов этой функции с параметром CurrentElement значением NULL возвращает первую запись в потоке контейнеров.

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

Требования

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

См. также

BTHDDI_SDP_PARSE_INTERFACE

Поделиться через