BTH_DEVICE_INFO-Struktur (bthdef.h)

Artikel
02/28/2024

Die BTH_DEVICE_INFO-Struktur speichert Informationen zu einem Bluetooth-Gerät.

Syntax

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;

Member

flags

Eine Kombination aus mindestens einem der in der folgenden Tabelle aufgeführten Flags.

Wert	Bedeutung
BDIF_ADDRESS	Das Adresselement enthält gültige Daten.
BDIF_COD	Der classOfDevice-Member enthält gültige Daten.
BDIF_NAME	Das Namenselement enthält gültige Daten.
BDIF_PAIRED	Das Gerät ist ein gespeichertes und authentifiziertes Gerät. Das flag BDIF_PERSONAL wird immer festgelegt, wenn dieses Flag festgelegt ist.
BDIF_PERSONAL	Das Gerät ist ein gespeichertes Gerät. Wenn dieses Flag festgelegt ist und das BDIF_PAIRED-Flag nicht festgelegt ist, wird das Gerät nicht authentifiziert.
BDIF_CONNECTED	Das Bluetooth-Remotegerät ist derzeit mit dem lokalen Funkgerät verbunden.
BDIF_SSP_SUPPORTED	Das Gerät unterstützt die Verwendung von Secure Simple Pairing (SSP).
BDIF_SSP_PAIRED	Das Gerät wird gespeichert und mithilfe von Secure Simple Pairing (SSP) authentifiziert.
BDIF_SSP_MITM_PROTECTED	Das Gerät unterstützt die Verwendung von Secure Simple Pairing (SSP) zum Schutz vor "Man in the Middle"-Angriffen.

address

Adresse des Bluetooth-Remotegeräts.

classOfDevice

Bitfeld, das die Geräteklasse des Geräts (COD) des Remotegeräts beschreibt. Der COD besteht aus den folgenden vier Feldern:

Format: Wird mit GET_COD_FORMAT(classOfDevice) abgerufen. Das einzige derzeit unterstützte Format ist COD_VERSION.

Haupt: wird mit dem GET_COD_MAJOR(classOfDevice) abgerufen. Die folgenden Werte sind derzeit definiert, aber es wird erwartet, dass die Liste erweitert wird. Verwenden Sie nicht das Hauptklassenfeld, um zu bestimmen, mit welchem Remotegerät eine Verbindung hergestellt werden soll. Ein Remotegerät verfügt möglicherweise nur über einen Hauptklassencode und ist möglicherweise nicht der geeignete Code für das angegebene Profil.

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

Nebenversion: wird mit GET_COD_MINOR(classOfDevice) abgerufen. Der Nebencode ist spezifisch für jeden Hauptcode, der definiert, wie sein Nebencode formatiert wird. Einige Nebencodes sind streng aufgezählte Werte. andere sind Bitfelder oder eine Kombination aus Bitfeldern und enumerierten Werten.

Diensthinweise: Wird mithilfe des GET_COD_SERVICE(classOfDevice) abgerufen. Enthält Hinweise zur Funktion des Remotegeräts.

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]

Name des Bluetooth-Remotegeräts, wie vom Gerät gemeldet, codiert in UTF8. Der Benutzer hat möglicherweise lokal einen Anzeigenamen für das Bluetooth-Remotegerät angegeben; dieser Name wird überschrieben und wird in diesem Element nicht angezeigt; Darauf kann nur mit einem Aufruf der BluetoothGetDeviceInfo-Funktion zugegriffen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Kopfzeile	bthdef.h

Weitere Informationen

BTH_QUERY_DEVICE

BTH_QUERY_SERVICE

BTH_SET_SERVICE

BluetoothGetDeviceInfo

Freigeben über