struktur BTH_DEVICE_INFO (bthdef.h)

Struktur BTH_DEVICE_INFO menyimpan informasi tentang perangkat Bluetooth.

Sintaks

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;

Anggota

flags

Kombinasi satu atau beberapa bendera yang tercantum dalam tabel berikut.

Nilai Makna
BDIF_ADDRESS
Anggota alamat berisi data yang valid.
BDIF_COD
Anggota classOfDevice berisi data yang valid.
BDIF_NAME
Anggota nama berisi data yang valid.
BDIF_PAIRED
Perangkat adalah perangkat yang diingat dan diautentikasi. Bendera BDIF_PERSONAL selalu diatur saat bendera ini diatur.
BDIF_PERSONAL
Perangkat adalah perangkat yang diingat. Jika bendera ini diatur dan bendera BDIF_PAIRED tidak diatur, perangkat tidak diautentikasi.
BDIF_CONNECTED
Perangkat Bluetooth jarak jauh saat ini tersambung ke radio lokal.
BDIF_SSP_SUPPORTED
Perangkat ini mendukung penggunaan Secure Simple Pairing (SSP).
BDIF_SSP_PAIRED
Perangkat diingat dan diautentikasi menggunakan Secure Simple Pairing (SSP).
BDIF_SSP_MITM_PROTECTED
Perangkat ini mendukung penggunaan Secure Simple Pairing (SSP) untuk melindungi dari serangan "Man in the Middle".

address

Alamat perangkat Bluetooth jarak jauh.

classOfDevice

Bidang bit yang menjelaskan kelas perangkat perangkat (COD) perangkat jarak jauh. COD terdiri dari empat bidang berikut:

Format: diambil menggunakan GET_COD_FORMAT(classOfDevice). Satu-satunya format yang saat ini didukung adalah COD_VERSION.

Utama: diambil menggunakan GET_COD_MAJOR(classOfDevice). Nilai berikut saat ini ditentukan, tetapi daftar diperkirakan akan diperluas. Jangan gunakan bidang kelas utama untuk menentukan perangkat jarak jauh mana yang akan disambungkan. Perangkat jarak jauh mungkin hanya memiliki satu kode kelas utama, dan mungkin bukan kode yang sesuai untuk profil yang diberikan.

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

Minor: diambil menggunakan GET_COD_MINOR(classOfDevice). Kode minor khusus untuk setiap kode utama, yang menentukan bagaimana kode minornya diformat. Beberapa kode minor adalah nilai yang dijumlahkan secara ketat; yang lain adalah bidang bit atau kombinasi bidang bit dan nilai yang dijumlahkan.

Petunjuk layanan: diambil menggunakan GET_COD_SERVICE(classOfDevice). Memberikan petunjuk tentang kemampuan perangkat jarak jauh.

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]

Nama perangkat Bluetooth jarak jauh, seperti yang dilaporkan oleh perangkat, dikodekan dalam UTF8. Pengguna mungkin telah secara lokal memberikan nama tampilan untuk perangkat Bluetooth jarak jauh; nama tersebut ditimpa, dan tidak muncul dalam anggota ini; hanya dapat diakses dengan panggilan ke fungsi BluetoothGetDeviceInfo .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista, Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung Tidak ada yang didukung
Header bthdef.h

Lihat juga

BTH_QUERY_DEVICE

BTH_QUERY_SERVICE

BTH_SET_SERVICE

BluetoothGetDeviceInfo