Partager via

MessageBeep, fonction (winuser.h)

  • Article

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.

 
Remarque 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 du panneau de configuration audio, puis stockés dans le Registre.

Ce paramètre peut être l’une des valeurs suivantes.

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

Valeur de retour

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’erreur étendues, 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 façon asynchrone.

S’il ne peut pas lire le son d’alerte spécifié, MessageBeep tente de lire le son système par défaut. S’il ne peut pas lire le son système par défaut, la fonction produit un son de bip standard à l’aide de la fonction Beep. À compter de Windows 7, cela lit une tonalité simple sur l’appareil audio par défaut. Pour plus d’informations, consultez la documentation relative à la fonction Beep.

L’utilisateur peut désactiver le bip d’avertissement à l’aide de l’application du panneau de configuration audio.

Remarque Pour envoyer un bip à un client distant, utilisez la fonction Beep. La fonction Beep est redirigée vers le client, tandis que MessageBeep n’est pas.

Exigences

Exigence Valeur
client minimum pris en charge Windows XP [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2003 [applications de bureau uniquement]
plateforme cible Windows
d’en-tête winuser.h (include 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

notifier l’utilisateur