CDseek(3dm)

NAME
     CDseek, CDseekupdate - set read pointer for CD-ROM to absolute time code
     location

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

     long CDseek(CDPLAYER* cd, int min, int sec, int frame)

     long CDseekupdate(CDPLAYER* cd, int min, int sec, int frame)

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

     min,sec,frame   The location in absolute time code to set the pointer to.

RETURNED VALUE
     If successful, CDseek(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
     CDseek(3dm) sets the pointer that indicates the starting point of the
     next read of digital audio data from a CD-ROM.  The pointer is set to an
     absolute time code location specified in minutes, seconds and frames.
     The value is stored internally as a logical block number.  One logical
     block is one CDFRAME.

     CDseek(3dm) does not verify that the location is readable or update the
     status data until a subsequent call to CDreadda(3dm) has been made.
     CDseekupdate(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), CDseekblock(3dm),
     CDseektrack(3dm), CDtctoframe(3dm), cdframe(4)

AUTHOR
     Mark Callow. Additions by Brandon Corey.