Utilisation de PlaySound pour lire des sons système
La fonction PlaySound lirea également les sons référencés par un nom de clé dans le registre. Les utilisateurs peuvent affecter leurs propres sons aux alertes et avertissements système, ou aux actions de l’utilisateur, telles qu’un clic de souris. Les sons associés aux alertes et avertissements système sont appelés événements sonores.
Pour lire un événement sonore, appelez PlaySound avec le paramètre pszSound pointant vers une chaîne contenant le nom de l’entrée de Registre qui identifie le son. Par exemple, pour lire le son associé à l’entrée « MouseClick » et attendre que le son se termine avant de revenir, utilisez l’instruction suivante :
PlaySound("MouseClick", NULL, SND_SYNC);
Si l’entrée de Registre spécifiée ou le fichier audio de forme d’onde qu’elle identifie n’existe pas, ou si le fichier ne tient pas dans la mémoire disponible, PlaySound lit le son système par défaut.
Les événements sonores prédéfinis par le système peuvent varier en fonction de la plateforme. La liste suivante fournit les événements sonores qui sont définis pour toutes les implémentations de l’API Win32 :
- SystemAsterisk
- SystemExclamation
- SystemExit
- SystemHand
- SystemQuestion
- SystemStart
Si une application enregistre ses propres événements sonores, l’utilisateur peut configurer l’événement sonore à l’aide de l’interface Panneau de configuration standard. L’application doit inscrire l’événement sonore à l’aide des fonctions de registre standard ; Pour plus d’informations, consultez Registre. Les entrées appartiennent à la même position dans la hiérarchie du Registre que le reste des événements sonores. Cette position varie en fonction de l’implémentation Win32. La valeur de données appropriée varie également en fonction de l’implémentation.
La fonction sndPlaySound recherche toujours dans le registre un nom de clé correspondant à lpszSound avant d’essayer de charger un fichier portant ce nom. La fonction PlaySound accepte les indicateurs qui spécifient l’emplacement du son.