CDstop(3dm)

NAME
     CDstop - stops play of an audio CD in CD-ROM drive

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

     int CDstop(CDPLAYER* cd)

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

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

DESCRIPTION
     CDstop(3dm) stops the current play operation.  CDstop(3dm) has no effect
     if no play operation is in progress.  CDstop(3dm) always changes the
     state field in the CDSTATUS structure associated with the CD-ROM drive to
     the value CD_READY.

WARNING
     The CDstop(3dm) function should not be used in conjunction with the
     CDreadda(3dm) function.

SEE ALSO
     CDintro(3dm), CDclose(3dm), CDgetstatus(3dm), CDgettrackinfo(3dm)
     CDopen(3dm), CDplay(3dm), CDplayabs(3dm), CDplaytrack(3dm),
     CDplaytrackabs(3dm) CDstop(3dm), CDtogglepause(3dm), CDeject(3dm)

AUTHOR
     Roger Chickering, Mark Callow