Signaltonfunktion (utilapiset.h)
Generiert einfache Töne auf dem Lautsprecher. Die Funktion ist synchron; es führt eine warnbare Wartezeit aus und gibt erst dann die Steuerung an den Anrufer zurück, wenn der Sound beendet ist.
Syntax
BOOL Beep(
[in] DWORD dwFreq,
[in] DWORD dwDuration
);
Parameter
[in] dwFreq
Die Frequenz des Klangs in Hertz. Dieser Parameter muss sich im Bereich 37 bis 32.767 (0x25 bis 0x7FFF) befinden.
[in] dwDuration
Die Dauer des Sounds in Millisekunden.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Vor langer Zeit haben alle PC-Computer einen gemeinsamen, programmierbaren 8254-Zeitgeberchip für die Generierung von primitiven Sounds gemeinsam genutzt. Die Signalton--Funktion wurde speziell geschrieben, um einen Signalton auf diesem Hardwareteil auszustrahlen.
Auf diesen älteren Systemen wirken sich Stummschaltungen und Lautstärkesteuerungen nicht auf Signalton-aus; Sie würden den Ton immer noch hören. Um den Ton zu stillen, haben Sie die folgenden Befehle verwendet:
net stop beep
sc config beep start= deaktiviert
Seitdem sind Soundkarten zu Standardgeräten auf fast allen PC-Computern geworden. Als Soundkarten häufiger wurden, begannen Hersteller, den alten Timerchip von Computern zu entfernen. Die Chips wurden auch von der Gestaltung von Servercomputern ausgeschlossen. Das Ergebnis ist, dass Beep nicht auf allen Computern ohne Chip funktionierte. Dies war in Ordnung, da die meisten Entwickler die MessageBeep--Funktion aufrufen konnten, die das Standardsoundgerät anstelle des 8254-Chip verwendet.
Aufgrund der fehlenden Hardware für die Kommunikation wurde die Unterstützung für die Wiedergabe von Sound vom Hauptplatinenlautsprecher in Windows Vista und Windows XP 64-Bit Edition eingestellt.
In Windows 7 wurde Beep umgeschrieben, um den Signalton an das Standardsoundgerät für die Sitzung zu übergeben. Dies ist normalerweise die Soundkarte, mit Ausnahme der Ausführung unter Terminaldienste, in diesem Fall wird der Signalton auf dem Client gerendert.
Beispiele
Im folgenden Beispiel wird die Verwendung dieser Funktion veranschaulicht.
Beep( 750, 300 );
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP [Desktop-Apps | UWP-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
| Zielplattform- | Fenster |
| Header- | utilapiset.h (include Windows.h) |
| Library | Kernel32.lib |
| DLL- | Kernel32.dll |