bthdef.h) (BTH_DEVICE_INFO 结构

项目
03/05/2024

BTH_DEVICE_INFO结构存储有关蓝牙设备的信息。

语法

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	远程蓝牙设备当前已连接到本地无线电。
BDIF_SSP_SUPPORTED	设备支持使用安全简单配对 (SSP) 。
BDIF_SSP_PAIRED	设备被记住并使用安全简单配对 (SSP) 进行身份验证。
BDIF_SSP_MITM_PROTECTED	设备支持使用安全简单配对 (SSP) 来防范“中间人”攻击。

address

远程蓝牙设备的地址。

classOfDevice

描述远程设备的设备 (COD) 的设备类的位字段。 COD 由以下四个字段组成：

格式：使用 GET_COD_FORMAT (classOfDevice) 检索。当前支持的唯一格式是 COD_VERSION。

主要：使用 GET_COD_MAJOR (类OfDevice) 检索。当前定义了以下值，但列表应会展开。不要使用主要类字段来确定要连接到哪个远程设备。远程设备可能只有一个主要类代码，并且可能不是给定配置文件的相应代码。

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 (类OfDevice) 检索。提供有关远程设备功能的提示。

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]

远程蓝牙设备的名称，由设备报告，以 UTF8 编码。用户可能已在本地为远程蓝牙设备提供了显示名称;该名称被重写，并且不在此成员中显示;它只能通过调用 BluetoothGetDeviceInfo 函数进行访问。

要求

要求	值
最低受支持的客户端	Windows Vista、Windows XP SP2 [仅限桌面应用]
最低受支持的服务器	无受支持的版本
标头	bthdef.h

另请参阅

BTH_QUERY_DEVICE

BTH_QUERY_SERVICE

BTH_SET_SERVICE

BluetoothGetDeviceInfo

通过