BTH_DEVICE_INFO構造体 (bthdef.h)

[アーティクル]
02/28/2024

BTH_DEVICE_INFO構造体には、Bluetooth デバイスに関する情報が格納されます。

構文

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

次の表に示す 1 つ以上のフラグの組み合わせ。

値	意味
BDIF_ADDRESS	アドレスメンバーに有効なデータが含まれています。
BDIF_COD	classOfDevice メンバーには有効なデータが含まれています。
BDIF_NAME	名前メンバーには有効なデータが含まれています。
BDIF_PAIRED	デバイスは、記憶され、認証されたデバイスです。このフラグが設定されている場合、BDIF_PERSONAL フラグは常に設定されます。
BDIF_PERSONAL	デバイスは記憶されたデバイスです。このフラグが設定され、 BDIF_PAIRED フラグが設定されていない場合、デバイスは認証されません。
BDIF_CONNECTED	現在、リモート Bluetooth デバイスはローカル無線に接続されています。
BDIF_SSP_SUPPORTED	デバイスでは、Secure Simple Pairing (SSP) の使用がサポートされています。
BDIF_SSP_PAIRED	デバイスは記憶され、セキュアシンプルペアリング (SSP) を使用して認証されます。
BDIF_SSP_MITM_PROTECTED	このデバイスでは、セキュリティで保護されたシンプルペアリング (SSP) を使用して、"中間者" 攻撃から保護できます。

address

リモート Bluetooth デバイスのアドレス。

classOfDevice

リモートデバイスのデバイスクラス (COD) を記述するビットフィールド。 COD は、次の 4 つのフィールドで構成されます。

形式: GET_COD_FORMAT(classOfDevice) を使用して取得されます。現在サポートされている形式はCOD_VERSIONのみです。

メジャー: GET_COD_MAJOR(classOfDevice) を使用して取得されます。現在、次の値が定義されていますが、一覧は展開される予定です。メジャークラスフィールドを使用して、接続先のリモートデバイスを決定しないでください。リモートデバイスには主要なクラスコードが 1 つだけあり、指定されたプロファイルに適したコードではない場合があります。

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 でエンコードされた、デバイスによって報告されるリモート Bluetooth デバイスの名前。ユーザーは、リモート Bluetooth デバイスの表示名をローカルで指定している可能性があります。その名前はオーバーライドされ、このメンバーには表示されません。 BluetoothGetDeviceInfo 関数の呼び出しでのみアクセスできます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista、WINDOWS XP と SP2 [デスクトップアプリのみ]
サポートされている最小のサーバー	サポートなし
Header	bthdef.h

こちらもご覧ください

BTH_QUERY_DEVICE

BTH_QUERY_SERVICE

BTH_SET_SERVICE

BluetoothGetDeviceInfo

次の方法で共有