Beep, fonction (utilapiset.h)
Génère des tonalités simples sur l’orateur. La fonction est synchrone ; il effectue une attente alertable et ne retourne pas le contrôle à son appelant tant que le son n’est pas terminé.
Syntaxe
BOOL Beep(
[in] DWORD dwFreq,
[in] DWORD dwDuration
);
Paramètres
[in] dwFreq
Fréquence du son, en hertz. Ce paramètre doit être comprise entre 37 et 32 767 (0x25 à 0x7FFF).
[in] dwDuration
Durée du son, en millisecondes.
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
Il y a longtemps, tous les ordinateurs PC ont partagé une puce de minuterie d’intervalle programmable 8254 commune pour la génération de sons primitifs. La fonction Beep a été écrite spécifiquement pour émettre un bip sur ce morceau de matériel.
Sur ces systèmes plus anciens, le mutage et les contrôles de volume n’ont aucun effet sur beep ; vous entendiez toujours le ton. Pour réduire le ton, vous avez utilisé les commandes suivantes :
bip net stop
sc config beep start= disabled
Depuis lors, les cartes audio sont devenues des équipements standard sur presque tous les ordinateurs PC. À mesure que les cartes sonores sont devenues plus courantes, les fabricants ont commencé à supprimer la puce du minuteur ancien des ordinateurs. Les puces ont également été exclues de la conception des ordinateurs serveurs. Le résultat est que beep ne fonctionnait pas sur tous les ordinateurs sans la puce. C’était correct parce que la plupart des développeurs avaient déménagé pour appeler la MessageBeep fonction qui utilise tout ce qui est l’appareil audio par défaut au lieu de la puce 8254.
Finalement, en raison du manque de matériel à communiquer, la prise en charge de la lecture du son à partir du haut-parleur de carte mère a été supprimée dans Windows Vista et Windows XP 64 Bits Edition.
Dans Windows 7, beep a été réécrit pour passer le bip à l’appareil audio par défaut pour la session. Il s’agit normalement de la carte audio, à l’exception de l’exécution sous Terminal Services, auquel cas le bip est rendu sur le client.
Exemples
L’exemple suivant illustre l’utilisation de cette fonction.
Beep( 750, 300 );
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP [applications de bureau | Applications UWP] |
| serveur minimum pris en charge | Windows Server 2003 [applications de bureau | Applications UWP] |
| plateforme cible | Windows |
| d’en-tête | utilapiset.h (include Windows.h) |
| bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |