struttura BTHHFP_DESCRIPTOR (bthhfpddi.h)

Articolo
02/22/2024

La struttura dei dati BTHHFP_DESCRIPTOR archivia le 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;

Members

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.

Commenti

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

Nota

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

Il driver audio non deve effettuare particolari ipotesi sui valori GUID della categoria restituiti nei membri InputPinCategory e OutputPinCategory . 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 ContainerId nei dati di contesto appropriati e restituisce questo valore nell'implementazione della proprietà KSPROPERTY_JACK_CONTAINERID KS.

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.