IOCTL_BTHHFP_MIC_GET_VOLUME_STATUS_UPDATE IOCTL (bthhfpddi.h)

Artikel
02/22/2024

Die IOCTL_BTHHFP_MIC_GET_VOLUME_STATUS_UPDATE IOCTL ruft die Lautstärkepegeleinstellung des Mikrofons des Bluetooth-Geräts 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 LONG-Wert, der den Lautstärkepegel des Mikrofons in 1/65536 Dezibel darstellt.

Länge des Ausgabepuffers

Die Größe eines LONG-Werts.

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 das Volume status seit der letzten Anforderung geändert hat. Andernfalls bleibt diese Anforderung ausstehend, bis das Volume änderungen status oder die Anforderung abgebrochen wird.

Der Audiotreiber sendet diese Anforderung, um die anfänglichen Lautsprecher- und Mikrofonlautstärken abzurufen, und sendet nachfolgende Anforderungen, die "auffordert", aktualisiert zu werden, wenn sich die Pegel ändern. Der Treiber speichert die Volumeebenen in entsprechenden Kontextdaten. Wenn sich die Lautstärke ändert, generiert der Audiotreiber das KSEVENT_CONTROL_CHANGE-Ereignis für den KSNODETYPE_VOLUME Knoten in der KS-Topologie des Lautsprecher- oder Mikrofonpfads.

Der Ausgabeparameter der Anforderung ist mit dem KSPROPERTY_AUDIO_VOLUMELEVEL-Eigenschaftswert identisch.