Home | History | Annotate | Download | only in man3
"SDL_CDOpen" "3" "Tue 11 Sep 2001, 22:58" "SDL" "SDL API Reference"
"NAME"
SDL_CDOpen - Opens a CD-ROM drive for access.
"SYNOPSIS"

#include "SDL.h" SDL_CD *SDL_CDOpen(int drive);

"DESCRIPTION"

Opens a CD-ROM drive for access. It returns a SDL_CD structure on success, or NULL if the drive was invalid or busy. This newly opened CD-ROM becomes the default CD used when other CD functions are passed a NULL CD-ROM handle.

Drives are numbered starting with 0. Drive 0 is the system default CD-ROM.

"EXAMPLES"

SDL_CD *cdrom;
int cur_track;
int min, sec, frame;
SDL_Init(SDL_INIT_CDROM);
atexit(SDL_Quit);

/* Check for CD drives */
if(!SDL_CDNumDrives()){
 /* None found */
 fprintf(stderr, "No CDROM devices available
");
 exit(-1);
}

/* Open the default drive */
cdrom=SDL_CDOpen(0);

/* Did if open? Check if cdrom is NULL */
if(!cdrom){
 fprintf(stderr, "Couldn't open drive: %s
", SDL_GetError());
 exit(-1);
}

/* Print Volume info */
printf("Name: %s
", SDL_CDName(0));
printf("Tracks: %d
", cdrom->numtracks);
for(cur_track=0;cur_track < cdrom->numtracks; cur_track++){
 FRAMES_TO_MSF(cdrom->track[cur_track].length, &min, &sec, &frame);
 printf(" Track %d: Length %d:%d
", cur_track, min, sec);
}

SDL_CDClose(cdrom);

"SEE ALSO"

SDL_CD, SDL_CDtrack, SDL_CDClose created by instant / docbook-to-man, Tue 11 Sep 2001, 22:58