struttura BTH_DEVICE_INFO (bthdef.h)

Articolo
08/22/2023

La struttura BTH_DEVICE_INFO archivia le informazioni su un dispositivo Bluetooth.

Sintassi

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;

Members

flags

Combinazione di uno o più flag elencati nella tabella seguente.

Valore	Significato
BDIF_ADDRESS	Il membro dell'indirizzo contiene dati validi.
BDIF_COD	Il membro classOfDevice contiene dati validi.
BDIF_NAME	Il membro del nome contiene dati validi.
BDIF_PAIRED	Il dispositivo è un dispositivo memorizzato e autenticato. Il flag BDIF_PERSONAL viene sempre impostato quando questo flag è impostato.
BDIF_PERSONAL	Il dispositivo è un dispositivo memorizzato. Se questo flag è impostato e il flag di BDIF_PAIRED non è impostato, il dispositivo non viene autenticato.
BDIF_CONNECTED	Il dispositivo Bluetooth remoto è attualmente connesso alla radio locale.
BDIF_SSP_SUPPORTED	Il dispositivo supporta l'uso di Secure Simple Pairing (SSP).
BDIF_SSP_PAIRED	Il dispositivo viene memorizzato e viene autenticato usando l'associazione sicura semplice (SSP).
BDIF_SSP_MITM_PROTECTED	Il dispositivo supporta l'uso di Secure Simple Pairing (SSP) per proteggersi dagli attacchi "Man in the Middle".

address

Indirizzo del dispositivo Bluetooth remoto.

classOfDevice

Campo Bit che descrive la classe di dispositivo del dispositivo (COD) del dispositivo remoto. Il COD è costituito dai quattro campi seguenti:

Formato: recuperato usando GET_COD_FORMAT(classOfDevice). L'unico formato attualmente supportato è COD_VERSION.

Principale: recuperato usando il GET_COD_MAJOR(classOfDevice). I valori seguenti sono attualmente definiti, ma è previsto che l'elenco venga espanso. Non usare il campo della classe principale per determinare a quale dispositivo remoto connettersi. Un dispositivo remoto può avere un solo codice di classe principale e potrebbe non essere il codice appropriato per il profilo specificato.

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

Secondario: recuperato usando GET_COD_MINOR(classOfDevice). Il codice secondario è specifico di ogni codice principale, che definisce la modalità di formattazione del codice secondario. Alcuni codici secondari sono rigorosamente valori enumerati; altri sono campi di bit o una combinazione di campi di bit e valori enumerati.

Hint di servizio: recuperati usando il GET_COD_SERVICE(classOfDevice). Fornisce suggerimenti sulla funzionalità del 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 del dispositivo Bluetooth remoto, come indicato dal dispositivo, codificato in UTF8. L'utente potrebbe aver fornito localmente un nome visualizzato per il dispositivo Bluetooth remoto; tale nome viene sottoposto a override e non viene visualizzato in questo membro; è accessibile solo con una chiamata alla funzione BluetoothGetDeviceInfo .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Nessuno supportato
Intestazione	bthdef.h

Vedi anche

BTH_QUERY_DEVICE

BTH_QUERY_SERVICE

BTH_SET_SERVICE

BluetoothGetDeviceInfo

Condividi tramite