1<HTML 2><HEAD 3><TITLE 4>SDL_CDOpen</TITLE 5><META 6NAME="GENERATOR" 7CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ 8"><LINK 9REL="HOME" 10TITLE="SDL Library Documentation" 11HREF="index.html"><LINK 12REL="UP" 13TITLE="CD-ROM" 14HREF="cdrom.html"><LINK 15REL="PREVIOUS" 16TITLE="SDL_CDName" 17HREF="sdlcdname.html"><LINK 18REL="NEXT" 19TITLE="SDL_CDStatus" 20HREF="sdlcdstatus.html"></HEAD 21><BODY 22CLASS="REFENTRY" 23BGCOLOR="#FFF8DC" 24TEXT="#000000" 25LINK="#0000ee" 26VLINK="#551a8b" 27ALINK="#ff0000" 28><DIV 29CLASS="NAVHEADER" 30><TABLE 31SUMMARY="Header navigation table" 32WIDTH="100%" 33BORDER="0" 34CELLPADDING="0" 35CELLSPACING="0" 36><TR 37><TH 38COLSPAN="3" 39ALIGN="center" 40>SDL Library Documentation</TH 41></TR 42><TR 43><TD 44WIDTH="10%" 45ALIGN="left" 46VALIGN="bottom" 47><A 48HREF="sdlcdname.html" 49ACCESSKEY="P" 50>Prev</A 51></TD 52><TD 53WIDTH="80%" 54ALIGN="center" 55VALIGN="bottom" 56></TD 57><TD 58WIDTH="10%" 59ALIGN="right" 60VALIGN="bottom" 61><A 62HREF="sdlcdstatus.html" 63ACCESSKEY="N" 64>Next</A 65></TD 66></TR 67></TABLE 68><HR 69ALIGN="LEFT" 70WIDTH="100%"></DIV 71><H1 72><A 73NAME="SDLCDOPEN" 74></A 75>SDL_CDOpen</H1 76><DIV 77CLASS="REFNAMEDIV" 78><A 79NAME="AEN7274" 80></A 81><H2 82>Name</H2 83>SDL_CDOpen -- Opens a CD-ROM drive for access.</DIV 84><DIV 85CLASS="REFSYNOPSISDIV" 86><A 87NAME="AEN7277" 88></A 89><H2 90>Synopsis</H2 91><DIV 92CLASS="FUNCSYNOPSIS" 93><A 94NAME="AEN7278" 95></A 96><P 97></P 98><PRE 99CLASS="FUNCSYNOPSISINFO" 100>#include "SDL.h"</PRE 101><P 102><CODE 103><CODE 104CLASS="FUNCDEF" 105>SDL_CD *<B 106CLASS="FSFUNC" 107>SDL_CDOpen</B 108></CODE 109>(int drive);</CODE 110></P 111><P 112></P 113></DIV 114></DIV 115><DIV 116CLASS="REFSECT1" 117><A 118NAME="AEN7284" 119></A 120><H2 121>Description</H2 122><P 123>Opens a CD-ROM drive for access. It returns a <A 124HREF="sdlcd.html" 125><SPAN 126CLASS="STRUCTNAME" 127>SDL_CD</SPAN 128></A 129> structure on success, or <TT 130CLASS="LITERAL" 131>NULL</TT 132> if the drive was invalid or busy. This newly opened CD-ROM becomes the default CD used when other CD functions are passed a <TT 133CLASS="LITERAL" 134>NULL</TT 135> CD-ROM handle. </P 136><P 137>Drives are numbered starting with 0. 138Drive 0 is the system default CD-ROM.</P 139></DIV 140><DIV 141CLASS="REFSECT1" 142><A 143NAME="AEN7292" 144></A 145><H2 146>Examples</H2 147><PRE 148CLASS="PROGRAMLISTING" 149>SDL_CD *cdrom; 150int cur_track; 151int min, sec, frame; 152SDL_Init(SDL_INIT_CDROM); 153atexit(SDL_Quit); 154 155/* Check for CD drives */ 156if(!SDL_CDNumDrives()){ 157 /* None found */ 158 fprintf(stderr, "No CDROM devices available\n"); 159 exit(-1); 160} 161 162/* Open the default drive */ 163cdrom=SDL_CDOpen(0); 164 165/* Did if open? Check if cdrom is NULL */ 166if(!cdrom){ 167 fprintf(stderr, "Couldn't open drive: %s\n", SDL_GetError()); 168 exit(-1); 169} 170 171/* Print Volume info */ 172printf("Name: %s\n", SDL_CDName(0)); 173printf("Tracks: %d\n", cdrom->numtracks); 174for(cur_track=0;cur_track < cdrom->numtracks; cur_track++){ 175 FRAMES_TO_MSF(cdrom->track[cur_track].length, &min, &sec, &frame); 176 printf("\tTrack %d: Length %d:%d\n", cur_track, min, sec); 177} 178 179SDL_CDClose(cdrom);</PRE 180></DIV 181><DIV 182CLASS="REFSECT1" 183><A 184NAME="AEN7295" 185></A 186><H2 187>See Also</H2 188><P 189><A 190HREF="sdlcd.html" 191><SPAN 192CLASS="STRUCTNAME" 193>SDL_CD</SPAN 194></A 195>, 196<A 197HREF="sdlcdtrack.html" 198><SPAN 199CLASS="STRUCTNAME" 200>SDL_CDtrack</SPAN 201></A 202>, 203<A 204HREF="sdlcdclose.html" 205><TT 206CLASS="FUNCTION" 207>SDL_CDClose</TT 208></A 209></P 210></DIV 211><DIV 212CLASS="NAVFOOTER" 213><HR 214ALIGN="LEFT" 215WIDTH="100%"><TABLE 216SUMMARY="Footer navigation table" 217WIDTH="100%" 218BORDER="0" 219CELLPADDING="0" 220CELLSPACING="0" 221><TR 222><TD 223WIDTH="33%" 224ALIGN="left" 225VALIGN="top" 226><A 227HREF="sdlcdname.html" 228ACCESSKEY="P" 229>Prev</A 230></TD 231><TD 232WIDTH="34%" 233ALIGN="center" 234VALIGN="top" 235><A 236HREF="index.html" 237ACCESSKEY="H" 238>Home</A 239></TD 240><TD 241WIDTH="33%" 242ALIGN="right" 243VALIGN="top" 244><A 245HREF="sdlcdstatus.html" 246ACCESSKEY="N" 247>Next</A 248></TD 249></TR 250><TR 251><TD 252WIDTH="33%" 253ALIGN="left" 254VALIGN="top" 255>SDL_CDName</TD 256><TD 257WIDTH="34%" 258ALIGN="center" 259VALIGN="top" 260><A 261HREF="cdrom.html" 262ACCESSKEY="U" 263>Up</A 264></TD 265><TD 266WIDTH="33%" 267ALIGN="right" 268VALIGN="top" 269>SDL_CDStatus</TD 270></TR 271></TABLE 272></DIV 273></BODY 274></HTML 275>