BTH_DEVICE_INFO 結構 (bthdef.h)

發行項
02/28/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 (classOfDevice) 擷取。目前已定義下列值，但列表預期會展開。請勿使用主要類別欄位來判斷要連線的遠端裝置。遠端裝置可能只有一個主要類別程式代碼，而且可能不是指定配置檔的適當程序代碼。

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 (classOfDevice) 擷取。提供遠端裝置功能的提示。

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

共用方式為