CDseekblock(3dm)

NAME
     CDseekblock - 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)

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.

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