CDplayabs(3dm)

NAME
     CDplayabs - play an audio CD (beginning at a specified absolute time
     location) through CD-ROM audio jacks

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

     int CDplayabs(CDPLAYER* cd, int min, int sec, int frame, int play)

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

     min,sec,frame   The coordinates of the absolute time location 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(3dm) can then be used to commence play.

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

DESCRIPTION
     CDplayabs(3dm) starts playback of an audio CD in the CD-ROM drive at the
     specified minutes, seconds, and frame number location in absolute
     timecode.  The audio output appears on the CD-ROM drive's headphone and
     audio jacks (if fitted).  Play stops at the end of the disc.

WARNING
     The CDplayabs(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