plucky (3) detect_midi_driver.3alleg4.gz

Provided by: allegro4-doc_4.4.3.1-5_all bug

NAME

       detect_midi_driver  -  Detects  whether  the  specified  MIDI  sound  device  is  available. Allegro game
       programming library.

SYNOPSIS

       #include <allegro.h>

       int detect_midi_driver(int driver_id);

DESCRIPTION

       Detects whether the specified MIDI sound device is available.  This  function  must  be  called  _before_
       install_sound().

RETURN VALUE

       Returns the maximum number of voices that the driver can provide, or zero if the hardware is not present.

       There are two special-case return values that you should watch out for: if this function returns -1 it is
       a note-stealing driver (eg. DIGMID) that shares voices with the current digital sound driver, and  if  it
       returns  0xFFFF  it  is  an  external  device like an MPU-401 where there is no way to determine how many
       voices are available.

SEE ALSO

       install_sound(3alleg4), reserve_voices(3alleg4)