CDseekblock(3dm)

NAME
     CDseekblock, CDseekblockupdate - set read pointer for CD-ROM to start of
     specified block

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

     unsigned long CDseekblock(CDPLAYER* cd, unsigned long block)

     unsigned long CDseekblockupdate(CDPLAYER* cd, unsigned long block)

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

     block   The logical block number to set the pointer to.

RETURNED VALUE
     If successful, CDseekblock(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
     CDseekblock(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
     the specified logical block number.  Logical block numbers are returned
     by CDseekblock.  A location in absolute time code can be converted to a
     logical block number by CDmsftoblock(3dm).  One logical block is one
     CDFRAME.

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

AUTHOR
     Mark Callow. Additions by Brandon Corey.