SoundSetWaveVolume

Ändert die Wave-Wiedergabelautstärke eines Audiogeräts.

SoundSetWaveVolume, Prozent , GerätNummer

Parameter

Prozent

Eine Prozentzahl zwischen -100 und 100 (kann eine Floating-Point-Zahl oder ein Ausdruck sein). Wenn die Zahl mit einem Plus- oder Minuszeichen beginnt, wird die aktuelle Lautstärke um den angegebenen Wert erhöht bzw. verringert. Andernfalls wird die Lautstärke explizit auf Prozent gesetzt.

GerätNummer

Wenn leer oder weggelassen, wird standardmäßig 1 (das erste Audiogerät) verwendet, was normalerweise das Standardgerät des Systems für Aufnahme und Wiedergabe ist. Andernfalls geben Sie eine Zahl größer als 1 an, um ein anderes Audiogerät zu verwenden.

Fehlerbehandlung

[v1.1.04+]: Dieser Befehl ist in der Lage, bei Misserfolg eine Ausnahme auszulösen. Weitere Informationen finden Sie unter Laufzeitfehler.

ErrorLevel wird bei Misserfolg auf 1 und bei Erfolg auf 0 gesetzt.

Bemerkungen

Die aktuelle Wave-Wiedergabelautstärke kann via SoundGetWaveVolume abgerufen werden. Einstellungen wie Master-Lautstärke, Synthesizer, Mikrofon, Stummschaltung, Höhe und Bass können mit SoundSet und SoundGet gesetzt bzw. abgerufen werden.

[v1.1.10+]: In Windows Vista und höher ist dieser Befehl äquivalent zu SoundSet, Prozent, Wave, Volume. Beide Befehle versuchen, die bestehende Balance zwischen den Kanälen beizubehalten.

Windows 2000/XP/2003: Im Gegensatz zu SoundSet versucht dieser Befehl, die bestehende Balance zwischen den Kanälen (z.B. links und rechts) beim Ändern der Lautstärke beizubehalten.

SoundGetWaveVolume, SoundSet, SoundGet, SoundPlay

Beispiele

Setzt die Wave-Wiedergabelautstärke auf den halben Pegelstand.

SoundSetWaveVolume, 50

Verringert die aktuelle Wave-Wiedergabelautstärke um 10 (z.B. von 80 auf 70).

SoundSetWaveVolume, -10

Erhöht die aktuelle Wave-Wiedergabelautstärke um 20.

SoundSetWaveVolume, +20