MessageBeep, fonction (winuser.h)

Lit un son de forme d’onde. Le son de forme d’onde pour chaque type de son est identifié par une entrée dans le registre.

 
Note Sur Windows Server 2022, la tâche Microsoft\Windows\Multimedia\SystemSoundsService dans le Planificateur de tâches est désactivée. Cette tâche doit être activée pour que MessageBeep fonctionne.

Syntaxe

BOOL MessageBeep(
  [in] UINT uType
);

Paramètres

[in] uType

Le son à jouer. Les sons sont définis par l’utilisateur via l’application Panneau de configuration Son, puis stockés dans le Registre.

Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
0xFFFFFFFF Un simple bip. Si la carte son n’est pas disponible, le son est généré à l’aide du haut-parleur.
MB_ICONASTERISK
0x000000040L
Voir MB_ICONINFORMATION.
MB_ICONEXCLAMATION
0x00000030L
Voir MB_ICONWARNING.
MB_ICONERROR
0x00000010L
Le son spécifié en tant que son d’arrêt critique Windows.
MB_ICONHAND
0x00000010L
Voir MB_ICONERROR.
MB_ICONINFORMATION
0x000000040L
Le son spécifié comme le son de l’astérisque Windows.
MB_ICONQUESTION
0x000000020L
Le son spécifié comme son de la question Windows.
MB_ICONSTOP
0x00000010L
Voir MB_ICONERROR.
MB_ICONWARNING
0x00000030L
Le son spécifié comme son d’exclamation Windows.
MB_OK
0x000000000L
Le son spécifié en tant que son de bip par défaut Windows.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Après la mise en file d’attente du son, la fonction MessageBeep retourne le contrôle à la fonction appelante et lit le son de manière asynchrone.

S’il ne peut pas lire le son d’alerte spécifié, MessageBeep tente de lire le son par défaut du système. Si elle ne peut pas lire le son par défaut du système, la fonction produit un bip standard via le haut-parleur de l’ordinateur.

L’utilisateur peut désactiver le bip d’avertissement à l’aide de l’application Panneau de configuration Son.

Note Pour envoyer un bip à un client distant, utilisez la fonction Beep . La fonction Beep est redirigée vers le client, alors que MessageBeep ne l’est pas.

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winuser.h (inclure Windows.h)
Bibliothèque User32.lib
DLL User32.dll
Ensemble d’API ext-ms-win-ntuser-misc-l1-1-0 (introduit dans Windows 8)

Voir aussi

Beep

Fonctions de gestion des erreurs

FlashWindow

Notification de l’utilisateur