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

다음 표에 나열된 하나 이상의 플래그 조합입니다.

값	의미
BDIF_ADDRESS	주소 멤버에 유효한 데이터가 포함됩니다.
BDIF_COD	classOfDevice 멤버에는 유효한 데이터가 포함됩니다.
BDIF_NAME	이름 멤버에 유효한 데이터가 포함됩니다.
BDIF_PAIRED	디바이스는 기억되고 인증된 디바이스입니다. 이 플래그가 설정되면 항상 BDIF_PERSONAL 플래그가 설정됩니다.
BDIF_PERSONAL	디바이스가 기억되는 디바이스입니다. 이 플래그가 설정되고 BDIF_PAIRED 플래그가 설정되지 않은 경우 디바이스가 인증되지 않습니다.
BDIF_CONNECTED	원격 Bluetooth 디바이스는 현재 로컬 라디오에 연결되어 있습니다.
BDIF_SSP_SUPPORTED	디바이스는 SSP(보안 단순 페어링)의 사용을 지원합니다.
BDIF_SSP_PAIRED	디바이스는 기억되며 SSP(보안 단순 페어링)를 사용하여 인증됩니다.
BDIF_SSP_MITM_PROTECTED	디바이스는 SSP(보안 단순 페어링)를 사용하여 "중간의 남자" 공격으로부터 보호할 수 있도록 지원합니다.

address

원격 Bluetooth 디바이스의 주소입니다.

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]

디바이스에서 보고한 원격 Bluetooth 디바이스의 이름으로 UTF8로 인코딩됩니다. 사용자가 원격 Bluetooth 디바이스에 대한 표시 이름을 로컬로 제공했을 수 있습니다. 이름이 재정의되고 이 멤버에 표시되지 않습니다. BluetoothGetDeviceInfo 함수를 호출하는 경우에만 액세스할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
머리글	bthdef.h

추가 정보

BTH_QUERY_DEVICE

BTH_QUERY_SERVICE

BTH_SET_SERVICE

BluetoothGetDeviceInfo