IOCTL_SBAUD_GET_VOLUME_STATUS_UPDATE IOCTL (sidebandaudio.h)

Die IOCTL_SBAUD_GET_VOLUME_STATUS_UPDATE IOCTL ruft die Lautstärkeeinstellung des Seitenband-Audioendpunkts ab.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

SIDEBANDAUDIO_VOLUME_PARAMS Struktur mit dem 0-basierten Endpunktindex und der Kanalnummer zusammen mit dem Parameter "immediate", der angibt, ob diese IOCTL sofort verarbeitet oder für zukünftige Updates verwendet werden soll.

Länge des Eingabepuffers

Größe der SIDEBANDAUDIO_VOLUME_PARAMS.

Ausgabepuffer

SIDEBANDAUDIO_VOLUME_PARAMS.

Länge des Ausgabepuffers

Größe der SIDEBANDAUDIO_VOLUME_PARAMS.

Statusblock

Irp-IoStatus.Status> wird auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist. Andernfalls wird Status zur entsprechenden Fehlerbedingung als NTSTATUS-Code verwendet. Weitere Informationen finden Sie unter NTSTATUS-Werte.

Hinweise

Diese IOCTL kann nur im Kernelmodus aufgerufen werden.

Die Volumeupdate-IOCTL kann in zwei Modi verwendet werden: update und sofort. Wenn SIDEBANDAUDIO_VOLUME_PARAMS::Immediate der Parameter auf TRUE festgelegt ist, wird die IOCTL sofort mit dem aktuellen Volumewert für den angeforderten Kanal zurückgegeben. Wenn der Parameter Immediate auf FALSE festgelegt ist, wird der IRP vom Seitenbandaudiotreiber (z. B. USB-Audio) geschrieben, bis sich die Lautstärke des Geräts ändert. Der Audiotreiber sollte eine ausstehende Volume-IOCTL einrichten, um über Änderungen am Hardwarevolume benachrichtigt zu werden.

Anforderungen

Anforderung	Wert
Header	sidebandaudio.h

Weitere Informationen

SIDEBANDAUDIO_VOLUME_PARAMS

Einführung in E/A-Steuerungscodes

sidebandaudio.h