Freigeben über


Beep-Funktion (utilapiset.h)

Generiert einfache Töne über den Lautsprecher. Die Funktion ist synchron; Es führt eine warnbare Wartezeit aus und gibt die Steuerung nicht an den Aufrufer zurück, bis der Sound beendet ist.

Syntax

BOOL Beep(
  [in] DWORD dwFreq,
  [in] DWORD dwDuration
);

Parameter

[in] dwFreq

Die Frequenz des Schalls in Hertz. Dieser Parameter muss im Bereich von 37 bis 32.767 liegen (0x25 bis 0x7FFF).

[in] dwDuration

Die Dauer des Sounds in Millisekunden.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Vor langer Zeit teilten sich alle PC-Computer einen gemeinsamen 8254 programmierbaren Intervalltimer-Chip für die Erzeugung von primitiven Sounds. Die Beep-Funktion wurde speziell geschrieben, um einen Signalton auf dieser Hardware auszustrahlen.

Bei diesen älteren Systemen haben Stummschaltungs- und Lautstärkeregler keine Auswirkungen auf den Signalton; Sie würden den Ton immer noch hören. Um den Ton zum Schweigen zu bringen, haben Sie die folgenden Befehle verwendet:

net stop beep

sc config beep start= disabled

Seitdem sind Soundkarten auf fast allen PC-Computern zur Standardausstattung geworden. Als Soundkarten immer häufiger wurden, begannen die Hersteller, den alten Timerchip von Computern zu entfernen. Die Chips wurden auch vom Entwurf von Servercomputern ausgeschlossen. Das Ergebnis ist, dass Der Signalton nicht auf allen Computern ohne den Chip funktionierte. Dies war in Ordnung, da die meisten Entwickler die MessageBeep-Funktion aufgerufen hatten, die anstelle des 8254-Chips das Standard-Soundgerät verwendet.

Aufgrund der fehlenden Hardware für die Kommunikation wurde die Unterstützung für Beep in Windows Vista und Windows XP 64-Bit Edition eingestellt.

In Windows 7 wurde der Signalton umgeschrieben, um den Signalton an das Standardsoundgerät für die Sitzung zu übergeben. Dies ist normalerweise der Sound Karte, außer wenn er unter Terminaldienste ausgeführt wird. In diesem Fall wird der Signalton auf dem Client gerendert.

Beispiele

Das folgende Beispiel zeigt die Verwendung dieser Funktion.

Beep( 750, 300 );

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile utilapiset.h (Windows.h einschließen)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

Fehlerbehandlungsfunktionen

MessageBeep

Benachrichtigen des Benutzers