структура BTH_DEVICE_INFO (bthdef.h)

Статья
03/14/2023

В структуре BTH_DEVICE_INFO хранятся сведения об устройстве Bluetooth.

Синтаксис

typedef struct _BTH_DEVICE_INFO {
  ULONG    flags;
  BTH_ADDR address;
  BTH_COD  classOfDevice;
  CHAR     name[BTH_MAX_NAME_SIZE];
} BTH_DEVICE_INFO, *PBTH_DEVICE_INFO;

Члены

flags

Сочетание одного или нескольких флагов, перечисленных в следующей таблице.

Значение	Значение
BDIF_ADDRESS	Член адреса содержит допустимые данные.
BDIF_COD	Член classOfDevice содержит допустимые данные.
BDIF_NAME	Элемент имени содержит допустимые данные.
BDIF_PAIRED	Устройство является запоминаемое и прошедшее проверку подлинности устройством. Флаг BDIF_PERSONAL всегда устанавливается при установке этого флага.
BDIF_PERSONAL	Устройство запоминается. Если этот флаг установлен, а флаг BDIF_PAIRED не задан, устройство не проходит проверку подлинности.
BDIF_CONNECTED	Удаленное устройство Bluetooth в настоящее время подключено к локальному радио.
BDIF_SSP_SUPPORTED	Устройство поддерживает использование безопасного простого связывания (SSP).
BDIF_SSP_PAIRED	Устройство запоминается и проходит проверку подлинности с помощью безопасного простого связывания (SSP).
BDIF_SSP_MITM_PROTECTED	Устройство поддерживает использование безопасного простого связывания (SSP) для защиты от атак "человек в середине".

address

Адрес удаленного устройства Bluetooth.

classOfDevice

Битовое поле, описывающее класс устройства (COD) удаленного устройства. КОД состоит из следующих четырех полей:

Формат: извлекается с помощью GET_COD_FORMAT(classOfDevice). Единственный поддерживаемый в настоящее время формат — COD_VERSION.

Основной: извлекается с помощью GET_COD_MAJOR(classOfDevice). В настоящее время определены следующие значения, но ожидается, что список будет расширяться. Не используйте поле основного класса, чтобы определить, к какому удаленному устройству следует подключиться. Удаленное устройство может иметь только один основной код класса и не подходит для заданного профиля.

COD_MAJOR_MISCELLANEOUS

COD_MAJOR_COMPUTER

COD_MAJOR_PHONE

COD_MAJOR_LAN_ACCESS

COD_MAJOR_AUDIO

COD_MAJOR_PERIPHERAL

COD_MAJOR_IMAGING

COD_MAJOR_UNCLASSIFIED

Дополнительный: извлекается с помощью GET_COD_MINOR(classOfDevice). Дополнительный код зависит от каждого основного кода, который определяет, как форматируется его дополнительный код. Некоторые второстепенные коды являются строго перечисленными значениями; другие — это битовые поля или сочетание битовых полей и перечисляемых значений.

Указания службы: извлекаются с помощью GET_COD_SERVICE(classOfDevice). Предоставляет указания о возможностях удаленного устройства.

COD_SERVICE_LIMITED

COD_SERVICE_POSITIONING

COD_SERVICE_NETWORKING

COD_SERVICE_RENDERING

COD_SERVICE_CAPTURING

COD_SERVICE_OBJECT_XFER

COD_SERVICE_AUDIO

COD_SERVICE_TELEPHONY

COD_SERVICE_INFORMATION

name[BTH_MAX_NAME_SIZE]

Имя удаленного устройства Bluetooth, предоставленное устройством, в кодировке UTF8. Пользователь может локально указать отображаемое имя удаленного устройства Bluetooth; это имя переопределено и не отображается в этом элементе; он доступен только при вызове функции BluetoothGetDeviceInfo .

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Верхняя часть	bthdef.h

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

BTH_QUERY_DEVICE

BTH_QUERY_SERVICE

BTH_SET_SERVICE

BluetoothGetDeviceInfo

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