IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR2 IOCTL (bthhfpddi.h)

Die IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR2 IOCTL ruft beschreibende Informationen zum gekoppelten HFP-Gerät (Handsfree Profile) ab.

Dieses IOCTL ist in Windows 8.1 und höheren Betriebssystemen verfügbar und ersetzt IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Keine

Eingabepufferlänge

Keine

Ausgabepuffer

Ein Puffer, der eine BTHHFP_DESCRIPTOR2-Struktur enthält, gefolgt von allen anderen Daten, auf die die Struktur verweist. Dies ist richtig, wenn die Ausgabepuffergröße ausreichend ist und die Anforderung erfolgreich ist. Insbesondere enthält der Puffer Speicher für die Zeichenfolge, auf die das Feld FriendlyName der BTHHFP_DESCRIPTOR2-Struktur verweist.

Länge des Ausgabepuffers

Die Größe einer BTHHFP_DESCRIPTOR2 Struktur und daten, auf die verwiesen wird.

Statusblock

Wenn die Routine erfolgreich ist, wird Status auf STATUS_SUCCESS festgelegt, und der Informationsmember ist die Anzahl der Bytes, die die Routine in den Ausgabepuffer schreibt. Beachten Sie, dass dies größer als die Größe der BTHHFP_DESCRIPTOR2-Struktur sein kann, da der Ausgabepuffer andere Daten enthalten kann, auf die von der BTHHFP_DESCRIPTOR2-Struktur verwiesen wird.

Wenn Status auf STATUS_BUFFER_TOO_SMALL festgelegt ist, ist Information die Größe des Puffers, den der Aufrufer für diese Anforderung zuweisen soll.

Hinweise

Der Audiotreiber sendet diese Anforderung, um Informationen zu einer aktivierten GUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASS Geräteschnittstelle abzurufen. Die Informationen ändern sich nicht, während die Schnittstelle aktiviert ist, sondern können sich ändern, wenn die Schnittstelle deaktiviert ist. Daher sendet der Audiotreiber diese Anforderung kurz nach dem Ermitteln einer aktivierten Geräteschnittstelle und verwendet die Informationen, um eine geeignete KSFILTER_DESCRIPTOR Struktur zu erstellen.

Der Audiotreiber sendet diese Anforderung einmal mit einer Ausgabepuffergröße von null (0), um die erforderliche Ausgabepuffergröße zu bestimmen. In diesem Fall wird die Anforderung mit status STATUS_BUFFER_TOO_SMALL abgeschlossen, und der Parameter Information enthält die erforderliche Puffergröße. Der Audiotreiber weist dann den erforderlichen Speicher zu und sendet die Anforderung erneut. In der Regel behält ein Audiotreiber einen Zeiger auf diesen Speicherort in seinem Gerätekontext, um während späterer Aktivitäten referenzieren zu können.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1
Unterstützte Mindestversion (Server)	Windows Server 2012 R2
Kopfzeile	bthhfpddi.h

Weitere Informationen

BTHHFP_DESCRIPTOR2

Bluetooth HFP DDI IOCTLs

IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR