IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR2 IOCTL (bthhfpddi.h)
Die IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR2 IOCTL ruft beschreibende Informationen zum gekoppelten Handsfree-Profilgerät (HFP) ab.
Diese IOCTL ist in Windows 8.1 und höher verfügbar und ersetzt IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR.
Hauptcode
Eingabepuffer
Nichts
Eingabepufferlänge
Nichts
Ausgabepuffer
Ein Puffer mit einer BTHHFP_DESCRIPTOR2 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 durch das feld FriendlyName der BTHHFP_DESCRIPTOR2 Struktur verwiesen wird.
Länge des Ausgabepuffers
Die Größe einer BTHHFP_DESCRIPTOR2 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. Beachten Sie, dass dies größer als die Größe der BTHHFP_DESCRIPTOR2 Struktur sein kann, da der Ausgabepuffer möglicherweise andere Daten enthalten kann, auf die von der BTHHFP_DESCRIPTOR2 Struktur verwiesen wird.
Wenn der Status auf STATUS_BUFFER_TOO_SMALL festgelegt ist, ist Information die Größe des Puffers, den der Aufrufer für diese Anforderung zuweisen 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 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 hält 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.1 |
| mindestens unterstützte Server- | Windows Server 2012 R2 |
| Header- | bthhfpddi.h |