BTHHFP_DESCRIPTOR结构（bthhfpddi.h）

项目
02/06/2025

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 信息中包含的“蓝牙类设备”数据计算 InputPinCategory 和 OutputPinCategory GUID。音频驱动程序设置 KSPIN_DESCRIPTOR。类别输入和输出网桥引脚的成员到计算的 GUID。

注释

在某些情况下，输入和输出引脚类别可能相同。

音频驱动程序不应对 InputPinCategory 中返回的类别 GUID 值做出特定假设，并且 OutputPinCategory 成员。音频系统使用此信息来帮助确定设备类型（例如耳机与扬声器），以及是否将设备用于不同的目的，例如默认通信设备。

音频驱动程序将 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 的信息，请参阅蓝牙 HFP DDI IOCTLs。