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

Статья
08/07/2023

Функция 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.

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

None

Remarks

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

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

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

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

Требования

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

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

BTHDDI_SDP_PARSE_INTERFACE

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