IOCTL_BTHHFP_DEVICE_GET_CONNECTION_STATUS_UPDATE IOCTL (bthhfpddi.h)

Artikel
02/26/2024

Die IOCTL_BTHHFP_DEVICE_GET_CONNECTION_STATUS_UPDATE IOCTL ruft eine Verbindung 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

Eine BOOL, die die neue Verbindung status. TRUE, wenn verbunden. FALSE, wenn nicht verbunden.

Länge des Ausgabepuffers

Die Größe eines BOOL.

Statusblock

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

Hinweise

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

Der Audiotreiber sendet diese Anforderung, um die anfängliche Verbindung status abzurufen, und sendet nachfolgende Anforderungen, die aktualisiert werden, wenn sich der status ändert. Der Treiber speichert die Verbindung status in entsprechenden Kontextdaten.

Wenn die Anforderung abgeschlossen ist und eine Änderung im Verbindungs-status angibt, generiert der Audiotreiber das KSEVENT_PINCAPS_JACKINFOCHANGE KS-Ereignis.

Beim Behandeln der KSPROPERTY_JACK_DESCRIPTION KS-Eigenschaft legt der Audiotreiber das IsConnected-Element der KSJACK_DESCRIPTION-Struktur basierend auf der verbindungsbasierten status fest.