CatchMusic()

Syntaxe

Resultat = CatchMusic(#Music, *Memoire, Taille)

Charge un module musical déjà situé en mémoire.

Arguments

#Music	Le numéro d'identification du module musical. #PB_Any peut être utilisé pour générer automatiquement ce numéro.
*Memoire	L'adresse mémoire (du buffer) où se trouve le module.
Taille	Taille du tampon (buffer) en mémoire.

Valeur de retour

Renvoie une valeur non nulle en cas de succès, zéro sinon.

Remarques

Si le module #Music était déjà créé, il est automatiquement supprimé et remplacé par le nouveau.

Cette commande est utile pour inclure des modules musicaux directement dans l'exécutable avec la commande IncludeBinary. Néanmoins, n'abusez pas de cette fonctionnalité car un module musical inclus dans un exécutable consomme automatiquement de la mémoire supplémentaire (car tout l'exécutable, y compris les modules, sont chargés en mémoire).

Exemple

  CatchMusic(0, ?Music, ?MusicEnd-?Music)
  End

  DataSection
    Music: 
      IncludeBinary "Music.xm"
    MusicEnd:
  EndDataSection

Voir aussi

LoadMusic(), PlayMusic()

OS Supportés

Tous