estrutura BTH_DEVICE_INFO (bthdef.h)

Artigo
08/22/2023

A estrutura BTH_DEVICE_INFO armazena informações sobre um dispositivo Bluetooth.

Sintaxe

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;

Membros

flags

Uma combinação de um ou mais dos sinalizadores listados na tabela a seguir.

Valor	Significado
BDIF_ADDRESS	O membro do endereço contém dados válidos.
BDIF_COD	O membro classOfDevice contém dados válidos.
BDIF_NAME	O membro de nome contém dados válidos.
BDIF_PAIRED	O dispositivo é um dispositivo lembrado e autenticado. O sinalizador BDIF_PERSONAL é sempre definido quando esse sinalizador é definido.
BDIF_PERSONAL	O dispositivo é um dispositivo lembrado. Se esse sinalizador estiver definido e o sinalizador BDIF_PAIRED não estiver definido, o dispositivo não será autenticado.
BDIF_CONNECTED	No momento, o dispositivo Bluetooth remoto está conectado ao rádio local.
BDIF_SSP_SUPPORTED	O dispositivo dá suporte ao uso do SSP (Secure Simple Pairing).
BDIF_SSP_PAIRED	O dispositivo é lembrado e autenticado usando o SSP (Secure Simple Pairing).
BDIF_SSP_MITM_PROTECTED	O dispositivo dá suporte ao uso do SSP (Secure Simple Pairing) para proteger contra ataques "Homem no Meio".

address

Endereço do dispositivo Bluetooth remoto.

classOfDevice

Campo de bits que descreve a classe de dispositivo (COD) do dispositivo remoto. O COD consiste nos quatro campos a seguir:

Formato: recuperado usando GET_COD_FORMAT(classOfDevice). O único formato com suporte no momento é COD_VERSION.

Major: recuperado usando o GET_COD_MAJOR(classOfDevice). Os valores a seguir estão definidos no momento, mas espera-se que a lista seja expandida. Não use o campo de classe principal para determinar a qual dispositivo remoto se conectar. Um dispositivo remoto pode ter apenas um código de classe principal e pode não ser o código apropriado para o perfil especificado.

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

Secundário: recuperado usando GET_COD_MINOR(classOfDevice). O código secundário é específico para cada código principal, que define como seu código secundário é formatado. Alguns códigos secundários são valores estritamente enumerados; outros são campos de bits ou uma combinação de campos de bits e valores enumerados.

Dicas de serviço: recuperadas usando o GET_COD_SERVICE(classOfDevice). Fornece dicas sobre a funcionalidade do dispositivo remoto.

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]

Nome do dispositivo Bluetooth remoto, conforme relatado pelo dispositivo, codificado em UTF8. O usuário pode ter fornecido localmente um nome de exibição para o dispositivo Bluetooth remoto; esse nome é substituído e não aparece neste membro; ele é acessível somente com uma chamada para a função BluetoothGetDeviceInfo .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Cabeçalho	bthdef.h

Confira também

BTH_QUERY_DEVICE

BTH_QUERY_SERVICE

BTH_SET_SERVICE

BluetoothGetDeviceInfo

Compartilhar via