SoundGet

Ruft verschiedene Einstellungen eines Audiogeräts ab (Master-Stummschaltung, Master-Lautstärke usw.).

SoundGet, AusgabeVar , KomponenteTyp, ReglerTyp, GerätNummer

Parameter

AusgabeVar

Name der Ausgabevariable, in der die abgerufene Einstellung gespeichert werden soll, was je nach Reglertyp entweder eine Floating-Point-Zahl im Bereich von 0 bis 100 oder das Wort ON oder OFF ist. ON/OFF wird gesetzt, wenn ReglerTyp ONOFF, MUTE, MONO, LOUDNESS, STEREOENH oder BASSBOOST ist. Die Variable wird leer gemacht, wenn beim Abrufen der Einstellung ein Problem aufgetreten ist. Das Format der Floating-Point-Zahl, wie z.B. die Dezimalstellen, wird durch SetFormat bestimmt.

KomponenteTyp

Wenn leer oder weggelassen, wird standardmäßig MASTER verwendet. Andernfalls geben Sie eines der folgenden Wörter an: MASTER (synonym zu 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 möglich, dass die Komponente namens Auxiliary bei einigen Mixern unter ANALOG statt AUX zugänglich ist.

Wenn ein Gerät mehr als eine Instanz des Komponententyps hat (z.B. zwei vom Typ LINE), enthält die erste Instanz normalerweise die Wiedergabeeinstellungen und die zweite die Aufnahmeeinstellungen. Um auf eine andere Instanz als die erste zuzugreifen, fügen Sie einen Doppelpunkt und eine Nummer an. Zum Beispiel ist Analog:2 die zweite Instanz der analogen Komponente.

ReglerTyp

Wenn leer oder weggelassen, wird standardmäßig VOLUME verwendet. Andernfalls geben Sie eines der folgenden Wörter an: VOLUME (oder VOL), ONOFF, MUTE, MONO, LOUDNESS, STEREOENH, BASSBOOST, PAN, QSOUNDPAN, BASS, TREBLE, EQUALIZER oder die Nummer eines gültigen Reglertyps (siehe Soundkartenanalyse-Skript). Wenn der angegebene Komponententyp den angegebenen Reglertyp nicht hat, wird ErrorLevel das Problem kennzeichnen.

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

GerätNummer

Wenn leer oder weggelassen, wird standardmäßig 1 (das erste Audiogerät) oder in Windows Vista oder höher das Standard-Wiedergabegerät des Systems verwendet. Andernfalls geben Sie eine Nummer zwischen 1 und der Gesamtzahl der unterstützten Geräte an. Dieser Parameter kann ein Ausdruck sein. Das Soundkartenanalyse-Skript kann helfen, die zu verwendende Nummer zu ermitteln.

Fehlerbehandlung

[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. Andernfalls wird es auf einen der folgenden Sätze gesetzt:

Bemerkungen

[v1.1.10+]: Dieser Befehl unterstützt Windows Vista und höher.

Um den Leistungsumfang der installierten Audiogeräte (Mixer) zu ermitteln - z.B. die verfügbaren Komponenten- und Reglertypen - führen Sie das Soundkartenanalyse-Skript aus.

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

Mit SoundSet kann eine Einstellung geändert werden.

SoundSet, SoundGetWaveVolume, SoundSetWaveVolume, SoundPlay

Beispiele

Ermittelt und meldet die Master-Lautstärke.

SoundGet, master_volume
MsgBox, Master-Lautstärke ist bei %master_volume% Prozent.

Ermittelt und meldet die Master-Stummschalteinstellung.

SoundGet, master_mute,, Mute
MsgBox, Master-Stummschaltung ist zurzeit %master_mute%.

Ermittelt und meldet den Master-Basspegel, wenn möglich, andernfalls wird eine Fehlermeldung angezeigt.

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

Ruft die Mikrofon-Stummschalteinstellung ab. Wenn das Mikrofon nicht stummgeschaltet ist, wird ein Mitteilungsfenster angezeigt.

SoundGet, microphone_mute, Microphone, Mute
if (microphone_mute = "Off")
    MsgBox, Das Mikrofon ist nicht stummgeschaltet.