SDL_CDOpen

Langue: en

Version: 45501 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

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