SoundGetVolume

Ruft die Lautstärkeeinstellung eines Audiogeräts ab.

Einstellung := SoundGetVolume(Komponente, Gerät)

Parameter

Komponente

Typ: Zeichenkette oder Integer

Wenn leer oder weggelassen, wird standardmäßig die Master-Lautstärkeeinstellung verwendet. Andernfalls geben Sie den Anzeigenamen und/oder die Indexnummer der Komponente an, z.B. 1, "Line in" oder "Line in:2".

Weitere Informationen finden Sie unter Komponente (Sound-Funktionen).

Gerät

Typ: Zeichenkette oder Integer

Wenn leer oder weggelassen, wird standardmäßig das Standardwiedergabegerät des Systems verwendet (was nicht unbedingt Gerät 1 ist). Andernfalls geben Sie den Anzeigenamen und/oder die Indexnummer des Geräts an, z.B. 1, "Lautsprecher", "Lautsprecher:2" oder "Lautsprecher (Beispiel HD Audio)".

Weitere Informationen finden Sie unter Gerät (Sound-Funktionen).

Rückgabewert

Typ: Float

Diese Funktion gibt eine Floating-Point-Zahl zwischen 0.0 und 100.0 zurück.

Fehlerbehandlung

Es wird ein TargetError ausgelöst, wenn das Gerät oder die Komponente nicht gefunden werden konnte oder wenn die Komponente diesen Reglertyp nicht unterstützt. Andernfalls wird bei Misserfolg ein OSError ausgelöst.

Bemerkungen

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

Sound-Funktionen

Beispiele

Ermittelt und meldet die Master-Lautstärke.

MasterLautstärke := SoundGetVolume()
MsgBox "Master-Lautstärke ist bei " MasterLautstärke " Prozent."

Ermittelt und meldet die Abhörlautstärke des Mikrofons.

MikroLautstärke := SoundGetVolume("Mikrofon")
MsgBox "Abhörlautstärke des Mikrofons ist bei " MikroLautstärke " Prozent."

Ermittelt und meldet die Aufnahmelautstärke des Mikrofons.

MikroLautstärke := SoundGetVolume( , "Mikrofon")
MsgBox "Aufnahmelautstärke des Mikrofons ist bei " MikroLautstärke " Prozent."