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

Статья
08/07/2023

Функция Bluetooth SdpRetrieveUuid128 используется для копирования неровного 128-разрядного универсального уникального идентификатора (UUID) из потока SDP.

Синтаксис

PRETRIEVEUUID128 Pretrieveuuid128;

void Pretrieveuuid128(
  PUCHAR Stream,
  GUID *uuid128
)
{...}

Параметры

Stream

Указатель на ненаправленный 128-разрядный UUID.

uuid128

Указатель на выровненную переменную для получения 128-разрядного UUID.

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

None

Remarks

Функция SdpRetrieveUuid128 не ищет UUID для копирования. Параметр Stream должен указывать точный адрес извлекаемого идентификатора UUID.

Некоторые архитектуры процессора требуют, чтобы значения были выровнены в памяти, и при попытке получить доступ к неправильному значению будет возникать ошибка. Записи SDP создаются без учета правил выравнивания процессора. Когда записи SDP хранятся в памяти, они могут содержать элементы, которые не соответствуют правилам выравнивания локального процессора.

Функция SdpRetrieveUuid128 безопасно копирует идентификаторы UUID на компьютеры с требованиями к выравниванию и эффективно копирует идентификаторы UUID на компьютеры без требований. Кроме того, эта функция работает с идентификаторами UUID, которые выровнены правильно.

Эта функция не влияет на порядок байтов.

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

Требования

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

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

BTHDDI_SDP_PARSE_INTERFACE

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