estructura BTHHFP_DESCRIPTOR (bthhfpddi.h)
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.
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.
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.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 |
| Servidor mínimo compatible | Windows Server 2012 |
| Encabezado | bthhfpddi.h |
Consulte también
Estructuras DDI de Bluetooth HFP
IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR