struttura BTHHFP_DESCRIPTOR (bthhfpddi.h)

Articolo
02/06/2025

La struttura dei dati BTHHFP_DESCRIPTOR archivia informazioni che descrivono un dispositivo HFP (Handsfree Profile) associato.

Il driver HFP restituisce questa struttura di dati nel buffer di output per la richiesta di IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR.

Sintassi

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

Membri

InputPinCategory

Categoria di pin KS per la funzione di input del dispositivo HFP associato.

OutputPinCategory

Categoria di pin KS per la funzione di output del dispositivo HFP associato.

ContainerId

ID contenitore PnP per il dispositivo HFP associato.

SupportsVolume

Indica se il dispositivo HFP associato supporta il controllo del volume remoto.

VolumePropertyValuesSize

Se il controllo del volume remoto è supportato, questo membro contiene le dimensioni dei dati restituiti dalla richiesta di IOCTL_BTHHFP_DEVICE_GET_VOLUMEPROPERTYVALUES.

FriendlyName

Stringa indiretta che identifica il nome descrittivo leggibile del dispositivo HFP associato.

Osservazioni

Il driver HFP calcola le InputPinCategory e OutputPinCategory GUID in base ai dati "Classe Bluetooth del dispositivo" contenuti nelle informazioni SDP del dispositivo associato. Il driver audio imposta il KSPIN_DESCRIPTOR. Categoria membri per i pin del bridge di input e output ai GUID calcolati.

nota

In alcuni casi le categorie di pin di input e output possono essere uguali.

Il driver audio non deve fare particolari presupposti sui valori GUID della categoria restituiti nei InputPinCategory e OutputPinCategory membri. Il sistema audio usa queste informazioni per determinare il tipo di dispositivo (ad esempio, visore VR e altoparlanti) e se usare il dispositivo per scopi diversi, ad esempio il dispositivo di comunicazione predefinito.

Il driver audio archivia il ContainerId nei dati di contesto appropriati e restituisce questo valore nell'implementazione della proprietà KS KSPROPERTY_JACK_CONTAINERID.

Se SupportsVolume è true, il driver audio include il supporto del volume nella topologia KS.

Il driver audio usa la stringa restituita in FriendlyName per impostare la proprietà DEVPKEY_DeviceInterface_FriendlyName sull'interfaccia del dispositivo KSCATEGORY_AUDIO del filtro KS. A tale scopo, il driver audio chiama IoSetDeviceInterfacePropertyData e imposta il tipo di proprietà su DEVPROP_TYPE_STRING_INDIRECT. Una stringa di esempio è "@System32\drivers\bthhfenum.sys,#2;%1 mani libere%0..; (SomeDeviceName)". Si noti che si tratta di una stringa indiretta e pertanto non necessariamente della stringa leggibile che viene visualizzata direttamente in un'interfaccia utente. Il sistema audio usa questa stringa per generare stringhe localizzate usate per la visualizzazione all'utente, ad esempio nel pannello di controllo Suoni.

Per informazioni sugli IOCTLs che funzionano con questa struttura, vedere IOCTLs HFP DDI Bluetooth.