SoundGet

Ermittelt diverse Einstellungen eines Audiogeräts (Stummschalten, Gesamtlautstärke und so weiter).

SoundGet, AusgabeVar , Komponententyp, Kontrolltyp, Gerätenummer

Parameter

AusgabeVar

Name der Variable, in der die abgerufene Einstellung gespeichert werden soll, welche entweder eine Gleitkommazahl zwischen 0 und 100 oder das Wort ON oder OFF ist (gilt nur für die Kontrolltypen ONOFF, MUTE, MONO, LOUDNESS, STEREOENH und BASSBOOST). Die Variable wird leer gemacht, wenn ein Problem beim Abrufen der Einstellung aufgetreten ist. Das Format der Gleitkommazahl, z. B. deren Dezimalstellen, wird über SetFormat bestimmt.

Komponententyp

Fehlt dieser Parameter leer oder ist er leer, gilt standardmäßig das Wort MASTER. Ansonsten ist es eines der folgenden Wörter: MASTER (gleichbedeutend mit SPEAKERS), DIGITAL, LINE, MICROPHONE, SYNTH, CD, TELEPHONE, PCSPEAKER, WAVE, AUX, ANALOG, HEADPHONES oder N/A. Wenn das Audiogerät den angegebenen Komponententyp nicht hat, wird ErrorLevel das Problem kennzeichnen.

Es ist in einigen Mixern möglich, dass die Komponente mit der Bezeichnung Auxiliary über ANALOG anstatt über AUX aufrufbar ist.

Wenn ein Gerät mehr als eine Instanz vom Komponententyp hat (zum Beispiel zwei vom Typ LINE), enthält der erste Typ für gewöhnlich die Wiedergabeeinstellungen und der zweite Typ die Aufnahmeeinstellungen. Um auf eine andere Instanz als die erste zuzugreifen, muss nach diesem Parameter ein Doppelpunkt und eine Nummer erfolgen. Zum Beispiel: Analog:2 ist die zweite Instanz der analogen Komponente.

Kontrolltyp

Fehlt dieser Parameter oder ist er leer, gilt standardmäßig das Wort VOLUME. Ansonsten ist es eines der folgenden Wörter: VOLUME (oder VOL), ONOFF, MUTE, MONO, LOUDNESS, STEREOENH, BASSBOOST, PAN, QSOUNDPAN, BASS, TREBLE, EQUALIZER oder die Nummer eines gültigen Kontrolltyps (siehe Soundkartenanalyse-Skript). Wenn der Komponententyp den angegebenen Kontrolltyp nicht hat, wird ErrorLevel das Problem kennzeichnen.

Hinweis: Soundgeräte unterstützen üblicherweise nur VOLUME (oder VOL) und MUTE, auch wenn andere je nach Windows-Version und dem Soundgerät verfügbar sein könnten.

Gerätenummer

Eine Nummer zwischen 1 und Gesamtanzahl an unterstützten Geräten. Fehlt dieser Parameter, gilt standardmäßig 1 (das erste Audiogerät), oder in Windows Vista oder höher das Standardwiedergabegerät vom Betriebssystem. Dieser Parameter kann ein Ausdruck sein. Das Soundkartenanalyse-Skript könnte dabei helfen, welche Nummer verwendet werden soll.

ErrorLevel

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

ErrorLevel wird auf 0 gesetzt, wenn der Befehl erfolgreich war. Ansonsten wird es auf einen der folgenden Sätze gesetzt:

Bemerkungen

Seit v1.1.10 wird Windows Vista und höher unterstützt.

Um den Leistungsumfang der installierten Audiogeräte (Mixer) zu ermitteln -- z. B. verfügbare Komponenten- und Kontrolltypen -- führt man das Soundkartenanalyse-Skript aus.

Für mehr Funktionalität und feinere Audio-Steuerung ist die VA-Bibliothek besser geeignet.

Mit SoundSet kann eine Einstellung geändert werden.

Siehe auch

SoundSet, SoundGetWaveVolume, SoundSetWaveVolume, SoundPlay

Beispiele

SoundGet, master_volume
MsgBox, Gesamtlautstärke ist bei %master_volume% Prozent.

SoundGet, master_mute, , mute
MsgBox, Globale Stummschaltung ist zurzeit %master_mute%.

SoundGet, bass_level, Master, bass
if ErrorLevel
    MsgBox, Fehlerbeschreibung: %ErrorLevel%
else
    MsgBox, Der BASS-Pegel für MASTER ist bei %bass_level% Prozent.

SoundGet, microphone_mute, Microphone, mute
if microphone_mute = Off
    MsgBox, Das Mikrofon ist nicht stummgeschaltet.