IOCTL_BTHHFP_STREAM_GET_STATUS_UPDATE IOCTL (bthhfpddi.h)

Die IOCTL_BTHHFP_STREAM_GET_STATUS_UPDATE IOCTL ruft einen Streamkanal status Update ab.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Ein BOOL, der auf TRUE festgelegt ist, um ein sofortiges Update anzufordern. Legen Sie andernfalls auf FALSE fest.

Eingabepufferlänge

Die Größe eines BOOL.

Ausgabepuffer

Ein NT_STATUS Wert, der den neuen Streamkanal status darstellt. Ein Fehler status gibt an, dass der dem Stream zugeordnete synchrone verbindungsorientierte Kanal (SCO) geschlossen wurde und nicht wiederhergestellt werden kann.

Länge des Ausgabepuffers

Die Größe eines NT_STATUS-Objekts.

Statusblock

Wenn eine Anforderung bereits aussteht, schlägt die neue Anforderung fehl, und eine STATUS_INVALID_DEVICE_REQUEST Nachricht wird zurückgegeben.

Wenn eine Anforderung aussteht, wenn eine IOCTL_BTHHFP_CLOSE_STREAM_CHANNEL Anforderung auftritt, wird die ausstehende Anforderung abgebrochen, und der E/A-status-Block zeigt STATUS_CANCELLED an.

Hinweise

Diese Anforderung wird sofort abgeschlossen, wenn der Eingabeparameter TRUE ist oder wenn sich der Streamkanal status seit der letzten Anforderung geändert hat. Andernfalls bleibt diese Anforderung ausstehend, bis der Streamkanal Änderungen status oder die Anforderung abgebrochen wird.

Diese Anforderung ist nur zwischen einer erfolgreichen IOCTL_BTHHFP_STREAM_OPEN-Anforderung und einer nachfolgenden IOCTL_BTHHFP_STREAM_CLOSE-Anforderung gültig. Wenn diese Anforderung aussteht, wenn der Stream durch eine IOCTL_BTHHFP_STREAM_CLOSE-Anforderung geschlossen wird, wird die ausstehende Anforderung abgebrochen.

Ein Fehler status kann auftreten, wenn die Bluetooth-Verbindung gelöscht wird oder ähnliche Bedingungen auftreten. Obwohl solche Bedingungen selten sind, muss der Audiotreiber entwickelt werden, um sie zu bewältigen. Dieser Fehler status kann häufig fast gleichzeitig mit einer Verbindung auftreten, status in FALSE geändert wird. Der Audiotreiber sollte sich jedoch nicht auf diese Änderung der status verlassen, um festzustellen, ob die Bluetooth-Verbindung gelöscht wurde oder nicht.

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