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

Статья
08/07/2023

Функция Bluetooth SdpRetrieveUint64 используется для копирования несровненного 64-разрядного целого числа из потока SDP.

Синтаксис

PRETRIEVEUINT64 Pretrieveuint64;

void Pretrieveuint64(
  PUCHAR Stream,
  PULONGLONG pUint16
)
{...}

Параметры

Stream

Указатель на исходный адрес 64-разрядного целого числа без привязки.

pUint16

Указатель на адрес выровненной переменной для получения 64-разрядного целого числа.

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

None

Remarks

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

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

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

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

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

Требования

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

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

BTHDDI_SDP_PARSE_INTERFACE

Share via