estructura BTHHFP_DESCRIPTOR (bthhfpddi.h)

Artículo
02/22/2024

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 para la solicitud de 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 de contenedor de PnP para el 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.

Comentarios

El controlador HFP calcula los GUID InputPinCategory y OutputPinCategory basados en los datos de "Clase de dispositivo Bluetooth" contenidos en la información de SDP del dispositivo emparejado. El controlador de audio establece el KSPIN_DESCRIPTOR. Miembros de categoría de las patillas de puente de entrada y salida a los GUID calculados.

Nota

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

El controlador de audio no debe realizar suposiciones concretas sobre los valores GUID de categoría devueltos en los miembros InputPinCategory y 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 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 lo tanto, no necesariamente la cadena legible humana 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 ICTL que funcionan con esta estructura, consulte IoCTLs de Bluetooth HFP DDI.