detect_midi_driver(3alleg)

detect_midi_driver3alleg

Detects whether the specified midi sound device is available. allegro game programming library.

Usage

#include <allegro.h>

int detect_midi_driver(int driver_id);

Overview

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.

Releases

4 releases since Debian 3.1 (Sarge); the text changed 2 times.

  1. 3.1
  2. 4.0
  3. 5.0–6.0

From liballegro-doc 2:4.2.2-2.2 in Debian 6.0 (Squeeze). Parsed by carta from the page's man source.