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.
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. |
|
Voir MB_ICONINFORMATION. |
|
Voir MB_ICONWARNING. |
|
Le son spécifié en tant que son d’arrêt critique Windows. |
|
Voir MB_ICONERROR. |
|
Le son spécifié comme le son de l’astérisque Windows. |
|
Le son spécifié comme son de la question Windows. |
|
Voir MB_ICONERROR. |
|
Le son spécifié comme son d’exclamation Windows. |
|
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) |