CDplaytrack(3dm)

NAME
     CDplaytrack - play a specified track from an audio CD through CD-ROM
     audio jacks

SYNOPSIS
     #include <sys/types.h>
     #include <dmedia/cdaudio.h>

     int CDplaytrack(CDPLAYER* cd, int start, int play)

PARAMETERS
     cd      A pointer to the CDPLAYER structure representing the target CD-
             ROM drive.

     start   The number of the track at which to start playing the CD.

     play    If 0, play indicates that the CD will be set to an initial paused
             state by this function.  CDtogglepause can then be used to
             commence play.

RETURNED VALUE
     If successful, this function returns a non-zero value otherwise zero is
     returned.

DESCRIPTION
     CDplaytrack(3dm) starts playback of an audio CD in the CD-ROM drive at
     the specified track.  The audio output appears on the CD-ROM drive's
     headphone and audio jacks (if fitted).  Play stops at the end of the
     track.

WARNING
     The CDplaytrack(3dm) function should not be used in conjunction with the
     CDreadda(3dm) function.

SEE ALSO
     CDintro(3dm), CDclose(3dm), CDgetstatus(3dm), CDgettrackinfo(3dm),
     CDeject(3dm), CDopen(3dm), CDplay(3dm), CDreadda(3dm), CDstop(3dm),
     CDtogglepause(3dm)

AUTHOR
     Roger Chickering, Mark Callow