Condividi tramite

Funzione MessageBeep (winuser.h)

  • Articolo

Riproduce un suono waveform. Il suono waveform per ogni tipo di suono è identificato da una voce nel Registro di sistema.

 
Nota in Windows Server 2022, l'attività Microsoft\Windows\Multimedia\SystemSoundsService in Utilità di pianificazione è disabilitata. Questa attività dovrà essere abilitata per il funzionamento di MessageBeep.

Sintassi

BOOL MessageBeep(
  [in] UINT uType
);

Parametri

[in] uType

Il suono da riprodurre. I suoni vengono impostati dall'utente tramite l'applicazione pannello di controllo Audio e quindi archiviati nel Registro di sistema.

Questo parametro può essere uno dei valori seguenti.

Valore Significato
0xFFFFFFFF Un segnale acustico semplice. Se la scheda audio non è disponibile, il suono viene generato utilizzando l'altoparlante.
MB_ICONASTERISK
0x00000040L
 Vedere MB_ICONINFORMATION.
MB_ICONEXCLAMATION
0x00000030L
 Vedere MB_ICONWARNING.
MB_ICONERROR
0x00000010L
 Il suono specificato come suono Windows Critical Stop.
MB_ICONHAND
0x00000010L
 Vedere MB_ICONERROR.
MB_ICONINFORMATION
0x00000040L
 Suono specificato come suono asterisco di Windows.
MB_ICONQUESTION
0x00000020L
 Suono specificato come audio di Windows Question.
MB_ICONSTOP
0x00000010L
 Vedere MB_ICONERROR.
MB_ICONWARNING
0x00000030L
 Suono specificato come suono esclamativo di Windows.
MB_OK
0x00000000L
 Suono specificato come suono beep predefinito di Windows.

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

Dopo aver accodato il suono, la funzione MessageBeep restituisce il controllo alla funzione chiamante e riproduce il suono in modo asincrono.

Se non riesce a riprodurre il suono di avviso specificato, MessageBeep tenta di riprodurre il suono predefinito del sistema. Se non riesce a riprodurre il suono predefinito del sistema, la funzione produce un suono di segnale acustico standard usando la funzione Beep. A partire da Windows 7, viene riprodotto un tono semplice nel dispositivo audio predefinito. Per altri dettagli, vedere la documentazione relativa alla funzione beep.

L'utente può disabilitare l'avviso tramite l'applicazione pannello di controllo Audio.

Nota Per inviare un segnale acustico a un client remoto, usare la funzione Beep. La funzione Beep viene reindirizzata al client, mentre messageBeep non è.

Fabbisogno

Requisito Valore
client minimo supportato Windows XP [solo app desktop]
server minimo supportato Windows Server 2003 [solo app desktop]
piattaforma di destinazione Finestre
intestazione winuser.h (include Windows.h)
libreria User32.lib
dll User32.dll
set di API ext-ms-win-ntuser-misc-l1-1-0 (introdotto in Windows 8)

Vedere anche

Beep

funzioni di gestione degli errori

FlashWindow

Notifica all' utente