структура 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 . Аудиосистема использует эти сведения, чтобы определить тип устройства (например, гарнитуру или динамики) и использовать ли устройство для различных целей, таких как устройство связи по умолчанию.

 
Аудиодрайв хранит ContainerId в соответствующих контекстных данных и возвращает это значение в реализации свойства KSPROPERTY_JACK_CONTAINERID KS.

Если значение 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

См. также раздел

Bluetooth HFP DDI IOCTLs

Структуры DDI bluetooth HFP

IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR

IOCTL_BTHHFP_DEVICE_GET_VOLUMEPROPERTYVALUES

KSPIN_DESCRIPTOR. Категории

KSPROPERTY_JACK_CONTAINERID