BTHHFP_DESCRIPTOR-Struktur (bthhfpddi.h)

Artikel
02/22/2024

Die BTHHFP_DESCRIPTOR Datenstruktur speichert Informationen, die ein gekoppeltes HFP-Gerät (Handsfree Profile) beschreiben.

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;

Member

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 Remotevolumesteuerung 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.

Hinweise

Der HFP-Treiber berechnet die GUIDs InputPinCategory und OutputPinCategory basierend auf den "Bluetooth Class of Device"-Daten, die in den SDP-Informationen des gekoppelten Geräts enthalten sind. Der Audiotreiber legt die KSPIN_DESCRIPTOR fest. Kategoriemember für die Ein- und Ausgabebrücke an die berechneten GUIDs anheften.

Hinweis

In einigen Fällen können die Eingabe- und Ausgabepinkategorien identisch sein.

Der Audiotreiber sollte keine bestimmten Annahmen über die KATEGORIE-GUID-Werte treffen, die in den Membern InputPinCategory und OutputPinCategory zurückgegeben werden. Das Audiosystem verwendet diese Informationen, um den Gerätetyp (z. B. Headset im Vergleich zu Lautsprechern) zu bestimmen und zu bestimmen, ob das Gerät für verschiedene Zwecke wie das Standardkommunikationsgerät verwendet werden soll.

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

Wenn SupportsVolume true ist, enthält der Audiotreiber Volumeunterstützung in seiner 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. Hierzu ruft der Audiotreiber IoSetDeviceInterfacePropertyData auf und legt den Eigenschaftentyp auf DEVPROP_TYPE_STRING_INDIRECT fest. Eine Beispielzeichenfolge ist "@System32\drivers\bthhfenum.sys,#2;%1 Hands-Free%0..; (SomeDeviceName)". Beachten Sie, dass dies eine indirekte Zeichenfolge ist und daher nicht unbedingt die lesbare Zeichenfolge ist, die direkt in 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 Sound-Systemsteuerung.

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