IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR IOCTL (bthhfpddi.h)

Der Audiotreiber gibt den IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR Steuercode aus, um Informationen zu einer aktivierten GUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASS Geräteschnittstelle abzurufen.

Hinweis Dieses IOCTL ersetzt IOCTL_BTHHFP_DEVICE_GET_KSNODETYPES und IOCTL_BTHHFP_DEVICE_GET_CONTAINERID, die jetzt veraltet sind.

 

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Nichts.

Eingabepufferlänge

Nichts.

Ausgabepuffer

Ein Puffer mit einer BTHHFP_DESCRIPTOR Struktur gefolgt von anderen Daten, auf die von der Struktur verwiesen wird. Dies gilt, wenn die Ausgabepuffergröße ausreicht und die Anforderung erfolgreich ist. Insbesondere enthält der Puffer Speicher für die Zeichenfolge, auf die vom FriendlyName Feld der BTHHFP_DESCRIPTOR-Struktur verwiesen wird.

Länge des Ausgabepuffers

Die Größe einer BTHHFP_DESCRIPTOR Struktur und referenzierten Daten.

Statusblock

Wenn die Routine erfolgreich ist, wird status auf STATUS_SUCCESS festgelegt, und das Information Member ist die Anzahl der Bytes, die die Routine in den Ausgabepuffer schreibt.

Hinweis Dies kann größer als die Größe der BTHHFP_DESCRIPTOR Struktur sein, da der Ausgabepuffer möglicherweise andere Daten enthalten kann, auf die von der Struktur verwiesen wird.

 

Wenn der Status auf STATUS_BUFFER_TOO_SMALL festgelegt ist, sollte der Audiotreiber das Information Member lesen, um die Größe des Puffers abzurufen, den der Aufrufer für diese Anforderung zuordnen soll.

Bemerkungen

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

Der Audiotreiber sendet diese Anforderung einmal mit einer Ausgabepuffergröße von Null (0), um die erforderliche Ausgabepuffergröße zu ermitteln. In diesem Fall wird die Anforderung mit status STATUS_BUFFER_TOO_SMALL abgeschlossen und das Information Member auf die erforderliche Puffergröße festgelegt. Der Audiotreiber weist dann den erforderlichen Speicherplatz zu und sendet die Anforderung erneut. In der Regel speichert ein Audiotreiber einen Zeiger auf diesen Speicherort im Gerätekontext, um während der späteren Aktivität referenzieren zu können.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8
mindestens unterstützte Server-	Windows Server 2012
Header-	bthhfpddi.h

Siehe auch

Bluetooth HFP DDI IOCTLs

IOCTL_BTHHFP_DEVICE_GET_CONTAINERID

IOCTL_BTHHFP_DEVICE_GET_KSNODETYPES