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 信息中包含的“设备蓝牙类”数据计算 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 的信息，请参阅蓝牙 HFP DDI IOCTL。