estructura BTHHFP_DESCRIPTOR (bthhfpddi.h)

2025-02-06

La estructura de datos BTHHFP_DESCRIPTOR almacena información que describe un dispositivo emparejado de perfil manos libres (HFP).

El controlador HFP devuelve esta estructura de datos en el búfer de salida de la solicitud IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR.

Sintaxis

typedef struct _BTHHFP_DESCRIPTOR {
  GUID           InputPinCategory;
  GUID           OutputPinCategory;
  GUID           ContainerId;
  BOOL           SupportsVolume;
  ULONG          VolumePropertyValuesSize;
  UNICODE_STRING FriendlyName;
} BTHHFP_DESCRIPTOR, *PBTHHFP_DESCRIPTOR;

Miembros

InputPinCategory

Categoría de patillas KS para la función de entrada del dispositivo HFP emparejado.

OutputPinCategory

Categoría de patillas KS para la función de salida del dispositivo HFP emparejado.

ContainerId

Identificador del contenedor PnP del dispositivo HFP emparejado.

SupportsVolume

Indica si el dispositivo HFP emparejado admite el control de volumen remoto.

VolumePropertyValuesSize

Si se admite el control de volumen remoto, este miembro contiene el tamaño de los datos devueltos por la solicitud de IOCTL_BTHHFP_DEVICE_GET_VOLUMEPROPERTYVALUES.

FriendlyName

Cadena indirecta que identifica el nombre descriptivo legible del dispositivo HFP emparejado.

Observaciones

El controlador HFP calcula los InputPinCategory y OutputPinCategory GUID basados en los datos de "Clase de dispositivo Bluetooth" que se encuentran en la información de SDP del dispositivo emparejado. El controlador de audio establece el KSPIN_DESCRIPTOR. Categoría miembros de los pines de puente de entrada y salida a los GUID calculados.

nota

En algunos casos, las categorías de pin de entrada y salida pueden ser las mismas.

El controlador de audio no debe realizar ninguna suposición concreta sobre los valores GUID de categoría devueltos en inputPinCategory y miembros outputPinCategory. El sistema de audio usa esta información para ayudar a determinar el tipo de dispositivo (por ejemplo, auriculares frente a altavoces) y si se debe usar el dispositivo con distintos fines, como el dispositivo de comunicaciones predeterminado.

El controlador de audio almacena el ContainerId en los datos de contexto adecuados y devuelve este valor en su implementación de la propiedad KSPROPERTY_JACK_CONTAINERID KS.

Si supportsVolume es true, el controlador de audio incluye compatibilidad con el volumen en su topología KS.

El controlador de audio usa la cadena devuelta en FriendlyName para establecer la propiedad DEVPKEY_DeviceInterface_FriendlyName en la interfaz de dispositivo de KSCATEGORY_AUDIO del filtro KS. Para ello, el controlador de audio llama a IoSetDeviceInterfacePropertyData y establece el tipo de propiedad en DEVPROP_TYPE_STRING_INDIRECT. Una cadena de ejemplo es "@System32\drivers\bthhfenum.sys,#2;%1 manos libres%0..; (SomeDeviceName)". Tenga en cuenta que se trata de una cadena indirecta y, por tanto, no necesariamente la cadena legible que se muestra directamente en una interfaz de usuario. El sistema de audio usa esta cadena para generar cadenas localizadas usadas para mostrar al usuario, como en el panel de control Sonidos.

Para obtener información sobre las IOCTL que funcionan con esta estructura, consulte ioCTLs de HFP DDI de Bluetooth.