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 Diese IOCTL ersetzt IOCTL_BTHHFP_DEVICE_GET_KSNODETYPES und IOCTL_BTHHFP_DEVICE_GET_CONTAINERID , die nun veraltet sind.

 

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Keine.

Länge des Eingabepuffers

Keine.

Ausgabepuffer

Ein Puffer, der eine BTHHFP_DESCRIPTOR-Struktur enthält, gefolgt von allen anderen Daten, auf die von der -Struktur verwiesen wird. Dies ist der Fall, wenn die Größe des Ausgabepuffers ausreichend ist und die Anforderung erfolgreich ist. Insbesondere enthält der Puffer Speicher für die Zeichenfolge, auf die im Feld FriendlyName der BTHHFP_DESCRIPTOR-Struktur verwiesen wird.

Länge des Ausgabepuffers

Die Größe einer BTHHFP_DESCRIPTOR-Struktur und der daten, auf die verwiesen wird.

Statusblock

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

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

 

Wenn Status auf STATUS_BUFFER_TOO_SMALL festgelegt ist, sollte der Audiotreiber den Information-Member lesen, um die Größe des Puffers abzurufen, den der Aufrufer für diese Anforderung zuordnen 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, können sich jedoch ä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 geeignete KSFILTER_DESCRIPTOR Struktur zu erstellen.

Der Audiotreiber sendet diese Anforderung einmal mit einer Ausgabepuffergröße von 0 (0), um die erforderliche Ausgabepuffergröße zu bestimmen. In diesem Fall wird die Anforderung mit status STATUS_BUFFER_TOO_SMALL abgeschlossen und der Information-Member auf die erforderliche Puffergröße festgelegt. Der Audiotreiber ordnet dann den erforderlichen Speicherplatz zu und sendet die Anforderung erneut. In der Regel speichert ein Audiotreiber einen Zeiger auf diesen Speicherort in seinem Gerätekontext, um während späterer Aktivitäten darauf zu verweisen.

Anforderungen

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

Weitere Informationen

Bluetooth HFP DDI IOCTLs

IOCTL_BTHHFP_DEVICE_GET_CONTAINERID

IOCTL_BTHHFP_DEVICE_GET_KSNODETYPES