BTHHFP_DESCRIPTOR 구조체(bthhfpddi.h)

아티클
08/07/2023

BTHHFP_DESCRIPTOR 데이터 구조는 쌍을 이루는 HFP(핸즈프리 프로필) 디바이스를 설명하는 정보를 저장합니다.

HFP 드라이버는 IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR 요청에 대한 출력 버퍼에서 이 데이터 구조를 반환합니다.

구문

typedef struct _BTHHFP_DESCRIPTOR {
  GUID           InputPinCategory;
  GUID           OutputPinCategory;
  GUID           ContainerId;
  BOOL           SupportsVolume;
  ULONG          VolumePropertyValuesSize;
  UNICODE_STRING FriendlyName;
} BTHHFP_DESCRIPTOR, *PBTHHFP_DESCRIPTOR;

멤버

InputPinCategory

페어링된 HFP 디바이스의 입력 함수에 대한 KS 핀 범주입니다.

OutputPinCategory

쌍을 이루는 HFP 디바이스의 출력 함수에 대한 KS 핀 범주입니다.

ContainerId

페어링된 HFP 디바이스의 PnP 컨테이너 ID입니다.

SupportsVolume

쌍을 이루는 HFP 디바이스가 원격 볼륨 제어를 지원하는지 여부를 나타냅니다.

VolumePropertyValuesSize

원격 볼륨 제어가 지원되는 경우 이 멤버는 IOCTL_BTHHFP_DEVICE_GET_VOLUMEPROPERTYVALUES 요청에 의해 반환된 데이터의 크기를 포함합니다.

FriendlyName

쌍을 이루는 HFP 디바이스의 사람이 읽을 수 있는 친숙한 이름을 식별하는 간접 문자열입니다.

설명

HFP 드라이버는 쌍을 이루는 디바이스의 SDP 정보에 포함된 '디바이스의 Bluetooth 클래스' 데이터를 기반으로 InputPinCategory 및 OutputPinCategory GUID를 계산합니다. 오디오 드라이버는 KSPIN_DESCRIPTOR 설정합니다. 계산 GUID에 대한 입력 및 출력 브리지 핀의 범주 멤버입니다.

참고

경우에 따라 입력 및 출력 핀 범주가 동일할 수 있습니다.

오디오 드라이버는 InputPinCategory 및 OutputPinCategory 멤버에 반환된 범주 GUID 값에 대해 특별한 가정을 하지 않아야 합니다. 오디오 시스템은 이 정보를 사용하여 디바이스 유형(예: 헤드셋 및 스피커)과 기본 통신 디바이스와 같은 다양한 용도로 디바이스를 사용할지 여부를 결정하는 데 도움이 됩니다.

오디오 드라이버는 적절한 컨텍스트 데이터에 ContainerId 를 저장하고 KSPROPERTY_JACK_CONTAINERID KS 속성의 구현에서 이 값을 반환합니다.

SupportsVolume이 true이면 오디오 드라이버에 KS 토폴로지의 볼륨 지원이 포함됩니다.

오디오 드라이버는 FriendlyName 에서 반환된 문자열을 사용하여 KS 필터의 KSCATEGORY_AUDIO 디바이스 인터페이스에서 DEVPKEY_DeviceInterface_FriendlyName 속성을 설정합니다. 이를 위해 오디오 드라이버는 IoSetDeviceInterfacePropertyData를 호출하고 속성 형식을 DEVPROP_TYPE_STRING_INDIRECT 설정합니다. 문자열 예제는 "@System32\drivers\bthhfenum.sys,#2;%1 핸즈프리%0.; (SomeDeviceName)". 이는 간접 문자열이므로 사용자 인터페이스에 직접 표시되는 사람이 읽을 수 있는 문자열일 필요는 없습니다. 오디오 시스템은 이 문자열을 사용하여 소리 제어판과 같이 사용자에게 표시하는 데 사용되는 지역화된 문자열을 생성합니다.

이 구조에서 작동하는 IOCTL에 대한 자세한 내용은 Bluetooth HFP DDI IOCTL을 참조하세요.