void unload_midi( int identificador )

Descripción:

Descarga de memoria el módulo musical cuyo identificador se pasa como parámetro. Este identificador del módulo es el valor que retorna la función load_midi() al cargarlo en memoria.

Tras descargarse un módulo se deben extremar las precauciones para no continuar utilizándolo en el programa, en cuyo caso el programa correría el riesgo de bloquearse.

No es necesario descargar los módulos antes de finalizar el programa, ya que el sistema lo hará de forma automática. Luego, solamente deben descargarse de memoria cuando ya no se vayan a utilizar durante un tiempo determinado y se quiera liberar el espacio ocupado en la memoria del ordenador para cargar otros recursos (otros ficheros de gráficos, sonidos, fuentes, etc.).

MAIN_PROGRAM_CDIV
PRIVATE
    int id_midi;

BEGIN_PROGRAM

 set_gfx(GFX_AUTODETECT_WINDOWED);

 set_mode(m320x200);

 id_midi = load_midi("../help.mid", 0); // Carga un sonido del disco duro

 write(0, 160, 0, 1, "Pulse [ESPACIO] para descargar el midi.");

 while(scan_code != _space)
  FRAME;

 unload_midi(id_midi);

END_PROGRAM

Este ejemplo carga el módulo contenido en el archivo help.mid con la función load_midi().

El programa permanecerá esperando este módulo hasta que se pulse la tecla ESPACIO, momento en el que se finalizará el bucle principal y se descargará el módulo de memoria con la función unload_midi(), indicando como parámetro id_midi que es contiene el identificador del módulo devuelto al cargarlo.

Ver: load_midi() - midi()