структура BTHHFP_DESCRIPTOR (bthhfpddi.h)
В структуре данных BTHHFP_DESCRIPTOR хранятся сведения, описывающие устройство с парным профилем Handsfree (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
Категория контактов KS для входной функции сопряженного устройства HFP.
OutputPinCategory
Категория закрепления KS для выходной функции сопряженного устройства HFP.
ContainerId
Идентификатор контейнера PnP для сопряженного устройства HFP.
SupportsVolume
Указывает, поддерживает ли сопряженное устройство HFP удаленное управление громкостей.
VolumePropertyValuesSize
Если поддерживается удаленное управление громкостями, этот элемент содержит размер данных, возвращаемых запросом IOCTL_BTHHFP_DEVICE_GET_VOLUMEPROPERTYVALUES .
FriendlyName
Непрямая строка, определяющая понятное для человека имя сопряженного устройства HFP.
Комментарии
Драйвер HFP вычисляет GUID InputPinCategory и OutputPinCategory на основе данных класса Bluetooth устройства, содержащихся в сведениях SDP парного устройства. Звуковой драйвер задает KSPIN_DESCRIPTOR. Элементы категорий для входных и выходных мостов закрепляются на вычисляемых идентификаторах GUID.
В некоторых случаях категории входных и выходных контактов могут быть одинаковыми.
Звуковой драйвер не должен делать особых предположений о значениях GUID категории, возвращаемых в элементах InputPinCategory и OutputPinCategory . Аудиосистема использует эти сведения, чтобы определить тип устройства (например, гарнитуру или динамики) и использовать ли устройство для различных целей, таких как устройство связи по умолчанию.
Если значение SupportsVolume равно true, аудиодрайвер включает поддержку громкости в топологии KS.
Звуковой драйвер использует строку, возвращаемую в FriendlyName , для задания свойства DEVPKEY_DeviceInterface_FriendlyName в интерфейсе KSCATEGORY_AUDIO устройства фильтра KS. Для этого аудиодрайвер вызывает IoSetDeviceInterfacePropertyData и задает тип свойства DEVPROP_TYPE_STRING_INDIRECT. Пример строки: "@System32\drivers\bthhfenum.sys,#2;%1 Hands-Free%0...; (SomeDeviceName)". Обратите внимание, что это непрямая строка и, следовательно, не обязательно удобочитаемая строка, которая отображается непосредственно в пользовательском интерфейсе. Аудиосистема использует эту строку для создания локализованных строк, используемых для отображения пользователю, например на панели управления Звуки.
Сведения о библиотеках IOCTL, которые работают с этой структурой, см. в разделе IoCTLs Bluetooth HFP DDI.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 |
| Минимальная версия сервера | Windows Server 2012 |
| Верхняя часть | bthhfpddi.h |
См. также раздел
IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR