BTHHFP_DESCRIPTOR Struktur (bthhfpddi.h)

Artikel
02/06/2025

Die BTHHFP_DESCRIPTOR Datenstruktur speichert Informationen zur Beschreibung eines gekoppelten Handsfree-Profilgeräts (HFP).

Der HFP-Treiber gibt diese Datenstruktur im Ausgabepuffer für die IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR-Anforderung zurück.

Syntax

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

Angehörige

InputPinCategory

KS-Pinkategorie für die Eingabefunktion des gekoppelten HFP-Geräts.

OutputPinCategory

KS-Pinkategorie für die Ausgabefunktion des gekoppelten HFP-Geräts.

ContainerId

Die PnP-Container-ID für das gekoppelte HFP-Gerät.

SupportsVolume

Gibt an, ob das gekoppelte HFP-Gerät die Remotelautstärkesteuerung unterstützt.

VolumePropertyValuesSize

Wenn die Remotevolumesteuerung unterstützt wird, enthält dieses Element die Größe der von der IOCTL_BTHHFP_DEVICE_GET_VOLUMEPROPERTYVALUES Anforderung zurückgegebenen Daten.

FriendlyName

Eine indirekte Zeichenfolge, die den lesbaren Anzeigenamen des gekoppelten HFP-Geräts identifiziert.

Bemerkungen

Der HFP-Treiber berechnet die InputPinCategory und OutputPinCategory GUIDs basierend auf den Daten der Bluetooth-Klasse des Geräts, die in den SDP-Informationen des gekoppelten Geräts enthalten sind. Der Audiotreiber legt den KSPIN_DESCRIPTOR fest. Elemente der Kategorie für die Eingabe- und Ausgabebrücke an die berechneten GUIDs.

In einigen Fällen sind die Eingabe- und Ausgabe-Pin-Kategorien möglicherweise identisch.

Der Audiotreiber sollte keine bestimmten Annahmen über die Kategorie-GUID-Werte machen, die in InputPinCategory- und OutputPinCategory--Member zurückgegeben werden. Das Audiosystem verwendet diese Informationen, um den Gerätetyp (z. B. Headset und Lautsprecher) zu bestimmen und ob das Gerät für unterschiedliche Zwecke wie das Standardkommunikationsgerät verwendet werden soll.

Der Audiotreiber speichert die ContainerId- in entsprechenden Kontextdaten und gibt diesen Wert in der Implementierung der KSPROPERTY_JACK_CONTAINERID KS-Eigenschaft zurück.

Wenn SupportsVolume- "true" ist, enthält der Audiotreiber die Volumeunterstützung in der KS-Topologie.

Der Audiotreiber verwendet die in FriendlyName- zurückgegebene Zeichenfolge, um die DEVPKEY_DeviceInterface_FriendlyName-Eigenschaft auf der KSCATEGORY_AUDIO-Geräteschnittstelle des KS-Filters festzulegen. Dazu ruft der Audiotreiber IoSetDeviceInterfacePropertyData auf und legt den Eigenschaftstyp auf DEVPROP_TYPE_STRING_INDIRECT fest. Eine Beispielzeichenfolge ist "@System32\drivers\bthhfenum.sys,#2;%1 freihändige%0..; (SomeDeviceName)". Beachten Sie, dass dies eine indirekte Zeichenfolge ist und daher nicht unbedingt die lesbare Zeichenfolge, die direkt auf einer Benutzeroberfläche angezeigt wird. Das Audiosystem verwendet diese Zeichenfolge, um lokalisierte Zeichenfolgen zu generieren, die für die Anzeige für den Benutzer verwendet werden, z. B. in der Systemsteuerung für Sounds.

Informationen zu den IOCTLs, die mit dieser Struktur arbeiten, finden Sie unter Bluetooth HFP DDI IOCTLs.