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
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
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 |