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 Einstellung mit der angegebenen Menge nach oben oder nach unten reguliert. Andernfalls wird Prozent explizit gesetzt.

GerätNummer

Lässt man diesen Parameter weg, wird standardmäßig 1 verwendet (das erste Audiogerät), das für gewöhnlich das standardmäßig verwendete Aufnahme- und Wiedergabegerät des Systems ist. Geben Sie eine Zahl größer als 1 an, um mit einem anderen Audiogerät zu agieren.

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 derzeitige Wave-Wiedergabelautstärke kann mit SoundGetWaveVolume abgerufen werden. Einstellungen wie Master-Lautstärke, Synthesizer, Mikrofon, Stummschaltung, Höhe und Bass können mithilfe von SoundSet und SoundGet gesetzt oder abgerufen werden.

[v1.1.10+]: In Windows Vista und höher ist dieser Befehl das gleiche wie SoundGet, wenn Komponente auf Wave und Regler auf Volume gesetzt wird. Beide Befehle versuchen, die vorhandene Balance zwischen den Kanälen beizubehalten.

Windows 2000/XP/2003: Im Gegensatz zu SoundSet versucht dieser Befehl, die vorhandene 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. 80 wird zu 70).

SoundSetWaveVolume, -10

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

SoundSetWaveVolume, +20