1 <HTML 2 ><HEAD 3 ><TITLE 4 >SDL_CreateMutex</TITLE 5 ><META 6 NAME="GENERATOR" 7 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ 8 "><LINK 9 REL="HOME" 10 TITLE="SDL Library Documentation" 11 HREF="index.html"><LINK 12 REL="UP" 13 TITLE="Multi-threaded Programming" 14 HREF="thread.html"><LINK 15 REL="PREVIOUS" 16 TITLE="SDL_KillThread" 17 HREF="sdlkillthread.html"><LINK 18 REL="NEXT" 19 TITLE="SDL_DestroyMutex" 20 HREF="sdldestroymutex.html"></HEAD 21 ><BODY 22 CLASS="REFENTRY" 23 BGCOLOR="#FFF8DC" 24 TEXT="#000000" 25 LINK="#0000ee" 26 VLINK="#551a8b" 27 ALINK="#ff0000" 28 ><DIV 29 CLASS="NAVHEADER" 30 ><TABLE 31 SUMMARY="Header navigation table" 32 WIDTH="100%" 33 BORDER="0" 34 CELLPADDING="0" 35 CELLSPACING="0" 36 ><TR 37 ><TH 38 COLSPAN="3" 39 ALIGN="center" 40 >SDL Library Documentation</TH 41 ></TR 42 ><TR 43 ><TD 44 WIDTH="10%" 45 ALIGN="left" 46 VALIGN="bottom" 47 ><A 48 HREF="sdlkillthread.html" 49 ACCESSKEY="P" 50 >Prev</A 51 ></TD 52 ><TD 53 WIDTH="80%" 54 ALIGN="center" 55 VALIGN="bottom" 56 ></TD 57 ><TD 58 WIDTH="10%" 59 ALIGN="right" 60 VALIGN="bottom" 61 ><A 62 HREF="sdldestroymutex.html" 63 ACCESSKEY="N" 64 >Next</A 65 ></TD 66 ></TR 67 ></TABLE 68 ><HR 69 ALIGN="LEFT" 70 WIDTH="100%"></DIV 71 ><H1 72 ><A 73 NAME="SDLCREATEMUTEX" 74 ></A 75 >SDL_CreateMutex</H1 76 ><DIV 77 CLASS="REFNAMEDIV" 78 ><A 79 NAME="AEN7820" 80 ></A 81 ><H2 82 >Name</H2 83 >SDL_CreateMutex -- Create a mutex</DIV 84 ><DIV 85 CLASS="REFSYNOPSISDIV" 86 ><A 87 NAME="AEN7823" 88 ></A 89 ><H2 90 >Synopsis</H2 91 ><DIV 92 CLASS="FUNCSYNOPSIS" 93 ><A 94 NAME="AEN7824" 95 ></A 96 ><P 97 ></P 98 ><PRE 99 CLASS="FUNCSYNOPSISINFO" 100 >#include "SDL.h" 101 #include "SDL_thread.h"</PRE 102 ><P 103 ><CODE 104 ><CODE 105 CLASS="FUNCDEF" 106 >SDL_mutex *<B 107 CLASS="FSFUNC" 108 >SDL_CreateMutex</B 109 ></CODE 110 >(void);</CODE 111 ></P 112 ><P 113 ></P 114 ></DIV 115 ></DIV 116 ><DIV 117 CLASS="REFSECT1" 118 ><A 119 NAME="AEN7830" 120 ></A 121 ><H2 122 >Description</H2 123 ><P 124 >Create a new, unlocked mutex.</P 125 ></DIV 126 ><DIV 127 CLASS="REFSECT1" 128 ><A 129 NAME="AEN7833" 130 ></A 131 ><H2 132 >Examples</H2 133 ><PRE 134 CLASS="PROGRAMLISTING" 135 >SDL_mutex *mut; 136 137 mut=SDL_CreateMutex(); 138 . 139 . 140 if(SDL_mutexP(mut)==-1){ 141 fprintf(stderr, "Couldn't lock mutex\n"); 142 exit(-1); 143 } 144 . 145 /* Do stuff while mutex is locked */ 146 . 147 . 148 if(SDL_mutexV(mut)==-1){ 149 fprintf(stderr, "Couldn't unlock mutex\n"); 150 exit(-1); 151 } 152 153 SDL_DestroyMutex(mut); </PRE 154 ></DIV 155 ><DIV 156 CLASS="REFSECT1" 157 ><A 158 NAME="AEN7836" 159 ></A 160 ><H2 161 >See Also</H2 162 ><P 163 ><A 164 HREF="sdlmutexp.html" 165 ><TT 166 CLASS="FUNCTION" 167 >SDL_mutexP</TT 168 ></A 169 >, 170 <A 171 HREF="sdlmutexv.html" 172 ><TT 173 CLASS="FUNCTION" 174 >SDL_mutexV</TT 175 ></A 176 >, 177 <A 178 HREF="sdldestroymutex.html" 179 ><TT 180 CLASS="FUNCTION" 181 >SDL_DestroyMutex</TT 182 ></A 183 ></P 184 ></DIV 185 ><DIV 186 CLASS="NAVFOOTER" 187 ><HR 188 ALIGN="LEFT" 189 WIDTH="100%"><TABLE 190 SUMMARY="Footer navigation table" 191 WIDTH="100%" 192 BORDER="0" 193 CELLPADDING="0" 194 CELLSPACING="0" 195 ><TR 196 ><TD 197 WIDTH="33%" 198 ALIGN="left" 199 VALIGN="top" 200 ><A 201 HREF="sdlkillthread.html" 202 ACCESSKEY="P" 203 >Prev</A 204 ></TD 205 ><TD 206 WIDTH="34%" 207 ALIGN="center" 208 VALIGN="top" 209 ><A 210 HREF="index.html" 211 ACCESSKEY="H" 212 >Home</A 213 ></TD 214 ><TD 215 WIDTH="33%" 216 ALIGN="right" 217 VALIGN="top" 218 ><A 219 HREF="sdldestroymutex.html" 220 ACCESSKEY="N" 221 >Next</A 222 ></TD 223 ></TR 224 ><TR 225 ><TD 226 WIDTH="33%" 227 ALIGN="left" 228 VALIGN="top" 229 >SDL_KillThread</TD 230 ><TD 231 WIDTH="34%" 232 ALIGN="center" 233 VALIGN="top" 234 ><A 235 HREF="thread.html" 236 ACCESSKEY="U" 237 >Up</A 238 ></TD 239 ><TD 240 WIDTH="33%" 241 ALIGN="right" 242 VALIGN="top" 243 >SDL_DestroyMutex</TD 244 ></TR 245 ></TABLE 246 ></DIV 247 ></BODY 248 ></HTML 249 >