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

Статья
02/06/2025

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

Синтаксис

PRETRIEVEUINT64 Pretrieveuint64;

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

Параметры

Stream

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

pUint16

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

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

Никакой

Замечания

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

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

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

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

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

Требования

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

См. также

BTHDDI_SDP_PARSE_INTERFACE

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