Beep: Unterschied zwischen den Versionen

Aus API-Wiki
Wechseln zu: Navigation, Suche
K (As Long weggenommen, weitere kleinere Änderungen...)
 
(6 dazwischenliegende Versionen von 4 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
__NOTOC__
 
__NOTOC__
Mit der API [[Beep]] kann man über den Systemlautsprecher frequenzgesteuerte Töne erzeugen lassen.
+
Mit Hilfe der Funktion '''Beep''' können Töne mit vorgegebener Frequenz und Dauer über den Systemlautsprecher ausgegeben werden.
  
<PRE>
+
<syntaxhighlight lang="vb">
 
Declare Function Beep Lib "kernel32.dll" ( _
 
Declare Function Beep Lib "kernel32.dll" ( _
 
                 ByVal dwFreq As Long, _
 
                 ByVal dwFreq As Long, _
 
                 ByVal dwDuration As Long) As Long
 
                 ByVal dwDuration As Long) As Long
</PRE>
+
</syntaxhighlight>
  
 
+
==Parameter==
===Parameter===
 
 
''dwFreq''
 
''dwFreq''
:Die Frequenz des Tons in Hertz. Diese muss zwischen 37 und 32767 liegen, allerdings sind sie nur bis 16-20 kHz sinnvoll, da höhere Frequenzen nicht mehr wahrnehmbar sind.
+
:Die Frequenz des Tons in Hertz. Diese muss zwischen 37 und 32767 liegen. Es sind nur Frequenzen bis 16 kHz sinnvoll, da höhere Frequenzen nicht mehr wahrnehmbar sind.
  
 
''dwDuration''
 
''dwDuration''
:Die Länge des Tons in Millisekunden.
+
:Die Dauer des Tons in Millisekunden.
  
 
+
==Rückgabe(n)==
===Rückgabe(n)===
 
  
 
Die Funktion gibt einen Wert des Types ''Long'' ungleich 0 bei Erfolg, den Wert 0 bei Misserfolg zurück.<br>
 
Die Funktion gibt einen Wert des Types ''Long'' ungleich 0 bei Erfolg, den Wert 0 bei Misserfolg zurück.<br>
 
Sollte die Funktionsrückgabe 0 sein, so lässt sich durch ''Err.LastDLLError'' die Fehlernummer zurückgeben.
 
Sollte die Funktionsrückgabe 0 sein, so lässt sich durch ''Err.LastDLLError'' die Fehlernummer zurückgeben.
  
 +
==Beispiel==
  
===Beispiel===
+
<syntaxhighlight lang="vb">
 
 
<PRE>
 
 
Dim RetVal As Long
 
Dim RetVal As Long
  
Zeile 34: Zeile 31:
 
     'Error-Handler
 
     'Error-Handler
 
End If
 
End If
</PRE>
+
</syntaxhighlight>
  
 
+
==Hinweise==
===Hinweise===
 
  
 
Das Programm wird für die Dauer des Tons angehalten.
 
Das Programm wird für die Dauer des Tons angehalten.
  
 
+
==Betriebssystem==
===Betriebssystem===
 
  
 
*Windows 95 / 98 / Me (Hier werden die beiden Parameter allerdings ignoriert.)
 
*Windows 95 / 98 / Me (Hier werden die beiden Parameter allerdings ignoriert.)
Zeile 48: Zeile 43:
 
*Windows Vista
 
*Windows Vista
  
 
+
==Verweise==
===Verweise===
 
  
 
*MSDN US-Library [http://msdn2.microsoft.com/en-us/library/ms679277.aspx]
 
*MSDN US-Library [http://msdn2.microsoft.com/en-us/library/ms679277.aspx]
*Beispiel auf vbArchiv [http://www.vbarchiv.net/archiv/tipp_430.html]
+
*Beispiel bei vbArchiv [http://www.vbarchiv.net/archiv/tipp_430.html]
 
 
 
 
----
 
 
 
{{Benutzer:Bernhard Döbler/Vorlage:Zuständig|Urs-Björn Schmidt}}
 
  
[[Kategorie:Kernel]]
+
[[Kategorie:Sonstiges]]

Aktuelle Version vom 7. Oktober 2016, 21:21 Uhr

Mit Hilfe der Funktion Beep können Töne mit vorgegebener Frequenz und Dauer über den Systemlautsprecher ausgegeben werden.

Declare Function Beep Lib "kernel32.dll" ( _
                 ByVal dwFreq As Long, _
                 ByVal dwDuration As Long) As Long

Parameter

dwFreq

Die Frequenz des Tons in Hertz. Diese muss zwischen 37 und 32767 liegen. Es sind nur Frequenzen bis 16 kHz sinnvoll, da höhere Frequenzen nicht mehr wahrnehmbar sind.

dwDuration

Die Dauer des Tons in Millisekunden.

Rückgabe(n)

Die Funktion gibt einen Wert des Types Long ungleich 0 bei Erfolg, den Wert 0 bei Misserfolg zurück.
Sollte die Funktionsrückgabe 0 sein, so lässt sich durch Err.LastDLLError die Fehlernummer zurückgeben.

Beispiel

Dim RetVal As Long

'Ein 1 Sek. langes 'a'
RetVal = Beep(440&, 1000&)

If RetVal = 0 Then
    'Error-Handler
End If

Hinweise

Das Programm wird für die Dauer des Tons angehalten.

Betriebssystem

  • Windows 95 / 98 / Me (Hier werden die beiden Parameter allerdings ignoriert.)
  • Windows NT 4.0 / 2000 / XP
  • Windows Vista

Verweise

  • MSDN US-Library [1]
  • Beispiel bei vbArchiv [2]