mdGetName(3dm)							mdGetName(3dm)

NAME    [Toc]    [Back]

     mdGetName - return	a MIDI interface name

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/midi.h>

     char *mdGetName(int index)

DESCRIPTION    [Toc]    [Back]

     mdGetName returns a pointer to the	interface name associated with index.
     If	index does not correspond to a configured MIDI interface, mdGetName
     returns NULL.  The	range of valid values for index	is dynamic and extends
     from 0 to one less	than number of configured interfaces (which is
     returned by mdInit(3dm)).

     The return	value of mdGetName can be used as an argument for any routines
     which expect an interface name, such as mdOpenInPort(3dm) and
     mdOpenOutPort(3dm).  This routine is also commonly	used to	build menus or
     lists of available	ports.

RETURN VALUE    [Toc]    [Back]

     mdGetName returns a pointer to an internal	data structure.	 The
     application must not alter	or free	the string.

SEE ALSO    [Toc]    [Back]

     mdIntro(3dm), mdInit(3dm),	mdOpenInPort(3dm), mdOpenOutPort


									PPPPaaaaggggeeee 1111