структура BTHHFP_DESCRIPTOR (bthhfpddi.h)

Статья
02/06/2025

В структуре данных 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 вычисляет InputPinCategory и OutputPinCategory GUID на основе данных Bluetooth устройства, содержащихся в сведениях SDP парного устройства. Звуковой драйвер задает KSPIN_DESCRIPTOR. Категория члены входных и выходных мостов закреплений к вычисляемым идентификаторам GUID.

Примечание

В некоторых случаях категории входных и выходных закреплений могут совпадать.

Звуковой драйвер не должен делать определенных предположений о значениях GUID категории, возвращаемых в inputPinCategory и элементах OutputPinCategory. Звуковая система использует эти сведения для определения типа устройства (например, гарнитуры и динамиков) и того, следует ли использовать устройство для различных целей, таких как устройство связи по умолчанию.

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

Если SupportVolume имеет значение true, звуковой драйвер включает поддержку томов в топологии KS.

Звуковой драйвер использует строку, возвращенную в FriendlyName, чтобы задать свойство DEVPKEY_DeviceInterface_FriendlyName в интерфейсе KSCATEGORY_AUDIO устройства фильтра KS. Для этого звуковой драйвер вызывает IoSetDeviceInterfacePropertyData и задает для свойства тип DEVPROP_TYPE_STRING_INDIRECT. Примером строки является "@System32\drivers\bthhfenum.sys,#2;%1%0..; (SomeDeviceName)". Обратите внимание, что это непрямая строка, поэтому не обязательно удобочитаемая строка, которая отображается непосредственно в пользовательском интерфейсе. Звуковая система использует эту строку для создания локализованных строк, используемых для отображения пользователю, например на панели управления "Звуки".

Сведения о ioCTLs, которые работают с этой структурой, см. в ioCTLs Bluetooth HFP DDI.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8
минимальный поддерживаемый сервер	Windows Server 2012
заголовка	bthhfpddi.h

См. также

IoCTLs Bluetooth HFP DDI

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

IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR

IOCTL_BTHHFP_DEVICE_GET_VOLUMEPROPERTYVALUES

KSPIN_DESCRIPTOR. Категория

KSPROPERTY_JACK_CONTAINERID

Поделиться через