CDseektrack(3dm)

NAME
     CDseektrack, CDseektrackupdate - set read pointer for CD-ROM to start of
     specified track

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

     long CDseektrack(CDPLAYER* cd, int track)

     long CDseektrackupdate(CDPLAYER* cd, int track)

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

     track   The track number the pointer is to be set to.

RETURNED VALUE
     If successful, CDseektrack(3dm) returns the logical block number to which
     the pointer has been set.  Otherwise -1 is returned and errno is set to
     indicate the error.

DESCRIPTION
     CDseektrack(3dm) sets the pointer that indicates the starting point of
     the next read of digital audio data from a CD-ROM.  The specified track
     is looked up in the disc's table of contents and the pointer is set to
     the start of that track.  The value is stored internally as a logical
     block number.  One logical block is one CDFRAME.

     CDseektrack(3dm) does not verify that the location is readable or update
     the status data until a subsequent call to CDreadda(3dm) has been made.
     CDseektrackupdate(3dm) is slower (it reads the new location), but
     guarantees that subsequent calls to CDgetstatus(3dm) are accurate.

SEE ALSO
     CDintro(3dm), CDclose(3dm), CDgetstatus(3dm), CDgettrackinfo(3dm),
     CDmsftoblock(3dm), CDmsftoframe(3dm), CDopen(3dm), CDreadda(3dm),
     CDseek(3dm), CDseekblock(3dm), CDtctoframe(3dm), cdframe(4)

AUTHOR
     Mark Callow. Additions by Brandon Corey.