Création du vocabulaire musics pour eForth Windows
publication: 19 novembre 2026 / mis à jour 20 novembre 2026
Création du vocabulaire music
Il est toujours intéressant, en langage FORTH, d'isoler des définitions dans un vocabulaire
dédié. C'est déjà ce que fait eForth Windows en isolant les définitions graphiques dans le vocabulaire
graphics.
C'est ce que nous allons réaliser avec les fonctions sonores de windows en y accédant au
travers de mots définis dans le nouveau vocabulaire musics:
vocabulary musics
Accès à la librairie winmm.dll
Winmm.dll (Windows Multimedia) est la bibliothèque système historique de Windows dédiée aux services multimédias classiques. Elle expose notamment les fonctions de lecture audio simple, d'accès aux flux PCM (waveOut / waveIn), de contrôle du mixeur, de gestion du MIDI et des minuteries multimédia haute précision (timeGetTime). Bien que supplantée pour les usages exigeants par des API plus récentes, elle reste très pratique pour des accès audio directs ou du prototypage rapide.
Le code source complet des mots accédants aux fonctions de gestion sonore se trouve ici:
Winmm definitions for musics vocabulary

La partie applicative et les tests sont disponibles ici:
Le contenu de ces fichiers peut évoluer sans préavis.
Le mot Winmm permettant d'accéder aux fonctions de la librairie Winmm.dll est défini ainsi:
vocabulary musics only forth also windows also structures also musics definitions \ Loads the Windows dynamic-link library Winmm.dll and associates it with the \ Forth word Winmm in order to call its multimedia functions. z" Winmm.dll" dll Winmm
Définition de nouveaux mots dans le vocabulaire musics
Voici comment on définit un nouveau mot dans le dictionnaire musics:
\ Plays a sound specified by the given file name, resource, or alias z" PlaySoundA" 3 Winmm PlaySoundA ( pszSound hmod fdwSound -- fl )
Le mot Winmm demande deux paramètres:
- le nom de la fonction appelée dans Winmm.dll, ici la fonction PlaySoundA. Il n'est pas possible d'appeler une fonction inexistante dans la librairie dll cible.
- le nombre de paramètres exigés par le mot créé.
Le mot Winmm est suivi du mot à créer, ici PlaySoundA dans notre exemple.
Gestion des erreurs
Certains mots renvoient un drapeau d'exécution ou un code d'erreur. On va immédiatement prendre en compte la gestion de ces erreurs:
\ errors constants 0 constant MMSYSERR_NOERROR 5 constant MMSYSERR_INVALHANDLE 6 constant MMSYSERR_NODRIVER 7 constant MMSYSERR_NOMEM 8 constant MMSYSERR_NOTSUPPORTED \ Interrupts the program in the event of an error : mm-abort ( fl -- ) dup MMSYSERR_NOERROR = if drop exit then case MMSYSERR_INVALHANDLE of abort" The specified device handle is not valid" endof MMSYSERR_NODRIVER of abort" No device driver is present" endof MMSYSERR_NOMEM of abort" Unable to allocate or lock memory" endof MMSYSERR_NOTSUPPORTED of abort" The definition is not supported" endof endcase ; \ Interrupts the program if fl is false : mm-success ( fl -- ) if exit then abort" Undefined erreor" ;
Les mots mm-abort et mm-success gèrent les codes de retour
de certaines définitions. Exemple:
\ play a .wav file, return immediately : PlayWav ( zFile -- fl ) 0 SND_FILENAME SND_ASYNC or PlaySoundA mm-success ;
Conclusion
Pour voir tous les mots définis dans le vocabulaire musics, tapez:
musics vlist
Ce qui devrait afficher ce genre de contenu:
Instrument NoteOff NoteOn MidiShort MidiMsg MidiClose MidiOpen hMidi CALLBACK_NULL MIDI_MAPPER midiOutGetVolume midiOutSetVolume midiOutShortMsg midiOutReset midiOutClose midiOutOpen midiOutGetNumDevs SetVolume WAVE_FORMAT_PCM WAVE_MAPPER waveOutWrite waveOutUnprepareHeader waveOutPrepareHeader waveOutReset waveOutClose waveOutOpen waveOutGetVolume waveOutSetVolume waveOutGetNumDevs StopSound PlayWavLoop PlayWavSync PlayWav PlaySoundA SND_RESOURCE SND_FILENAME SND_ALIAS SND_NOWAIT SND_APPLICATION SND_PURGE SND_NOSTOP SND_LOOP SND_MEMORY SND_NODEFAULT SND_ASYNC SND_SYNC mm-success mm-abort MMSYSERR_NOTSUPPORTED MMSYSERR_NOMEM MMSYSERR_NODRIVER MMSYSERR_INVALHANDLE MMSYSERR_NOERROR Winmm
Legal: site web personnel sans commerce / personal site without seling
