Funzione Beep (utilapiset.h)

Genera toni semplici sull'altoparlante. La funzione è sincrona; esegue un'attesa avvisabile e non restituisce il controllo al chiamante fino al termine dell'audio.

Sintassi

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

Parametri

[in] dwFreq

La frequenza del suono, inhz. Questo parametro deve essere compreso nell'intervallo compreso tra 37 e 32.767 (da 0x25 a 0x7FFF).

[in] dwDuration

Durata del suono, espressa in millisecondi.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

Molto tempo fa, tutti i computer PC hanno condiviso un chip timer a intervalli programmabili 8254 comune per la generazione di suoni primitivi. La funzione Beep è stata scritta in modo specifico per generare un segnale acustico su tale componente hardware.

In questi sistemi meno recenti, i controlli di disattivazione e volume non hanno alcun effetto su Beep; sentiresti ancora il tono. Per disattivare il tono, sono stati usati i comandi seguenti:

di interruzione net stop

sc config beep start= disabled

Da allora, le schede audio sono diventate apparecchiature standard su quasi tutti i computer PC. Man mano che le schede audio sono diventate più comuni, i produttori iniziarono a rimuovere il vecchio chip timer dai computer. I chip sono stati esclusi anche dalla progettazione di computer server. Il risultato è che Beep non funzionava in tutti i computer senza il chip. Questo è stato corretto perché la maggior parte degli sviluppatori si è spostata a chiamare la funzione MessageBeep che usa qualsiasi dispositivo audio predefinito anziché il chip 8254.

Alla fine a causa della mancanza di hardware per comunicare con, il supporto per la riproduzione del suono dall'altoparlante della scheda madre è stato eliminato in Windows Vista e Windows XP 64 Bit Edition.

In Windows 7 Beep è stato riscritto per passare il segnale acustico al dispositivo audio predefinito per la sessione. Questa è in genere la scheda audio, tranne quando viene eseguita in Servizi terminal, nel qual caso il rendering del segnale acustico viene eseguito sul client.

Esempi

Nell'esempio seguente viene illustrato l'uso di questa funzione.

Beep( 750, 300 );

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [app desktop | App UWP]
server minimo supportato	Windows Server 2003 [app desktop | App UWP]
piattaforma di destinazione	Finestre
intestazione	utilapiset.h (include Windows.h)
libreria	Kernel32.lib
dll	Kernel32.dll

Vedere anche

funzioni di gestione degli errori

MessageBeep

Notifica all' utente