AwesomeAdam54321/inweb-bootstrap
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
inweb-bootstrap/docs/foundation-module/1-wp.html
Graham Nelson 512adb22a9 Cross-references to types and functions
2020-04-11 23:43:27 +01:00

373 lines
56 KiB
HTML
Raw Blame History

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Windows Platform</title>
<meta name="viewport" content="width=device-width initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta http-equiv="Content-Language" content="en-gb">
<link href="../inweb.css" rel="stylesheet" rev="stylesheet" type="text/css">
</head>
<body>
<nav role="navigation">
<h1><a href="../webs.html">Sources</a></h1>
<ul>
<li><a href="../inweb/index.html">inweb</a></li>
</ul>
<h2>Foundation</h2>
<ul>
<li><a href="../foundation-module/index.html">foundation-module</a></li>
<li><a href="../foundation-test/index.html">foundation-test</a></li>
</ul>
</nav>
<main role="main">
<!--Weave of 'Windows Platform' generated by 7-->
<ul class="crumbs"><li><a href="../webs.html">Source</a></li><li><a href="index.html">foundation</a></li><li><a href="index.html#1">Chapter 1: Setting Up</a></li><li><b>Windows Platform</b></li></ul><p class="purpose">A version of our operating system interface suitable for Microsoft Windows.</p>
<ul class="toc"><li><a href="#SP2">&#167;2. Microsoft Windows</a></li><li><a href="#SP4">&#167;4. Environment variables</a></li><li><a href="#SP5">&#167;5. Executable location</a></li><li><a href="#SP6">&#167;6. Shell commands</a></li><li><a href="#SP7">&#167;7. Directory handling</a></li><li><a href="#SP8">&#167;8. Sleep</a></li><li><a href="#SP9">&#167;9. Notifications</a></li><li><a href="#SP10">&#167;10. Concurrency</a></li><li><a href="#SP12">&#167;12. Timestamp</a></li><li><a href="#SP13">&#167;13. Mutexes</a></li></ul><hr class="tocbar">
<p class="inwebparagraph"><a id="SP1"></a><b>&#167;1. </b>This Foundation module comes with two variant versions of the <code class="display"><span class="extract">Platform::</span></code>
section of code. The one you're reading compiles on Windows, and the other
on a POSIX operating system.
</p>
<p class="endnote">This paragraph is used only if PLATFORM_WINDOWS is defined.</p>
<p class="inwebparagraph"><a id="SP2"></a><b>&#167;2. Microsoft Windows. </b></p>
<pre class="definitions">
<span class="definitionkeyword">define</span> <span class="constant">PLATFORM_STRING</span><span class="plain"> </span><span class="string">"windows"</span>
<span class="definitionkeyword">define</span> <span class="constant">LOCALE_IS_ISO</span>
<span class="definitionkeyword">define</span> <span class="constant">FOLDER_SEPARATOR</span><span class="plain"> </span><span class="character">'\\'</span>
<span class="definitionkeyword">define</span> <span class="constant">SHELL_QUOTE_CHARACTER</span><span class="plain"> </span><span class="character">'\"'</span>
<span class="definitionkeyword">define</span> <span class="constant">WINDOWS_JAVASCRIPT</span>
<span class="definitionkeyword">define</span> <span class="constant">INFORM_FOLDER_RELATIVE_TO_HOME</span><span class="plain"> </span><span class="string">""</span>
<span class="definitionkeyword">define</span> <span class="constant">HTML_MAP_FONT_SIZE</span><span class="plain"> </span><span class="constant">11</span>
</pre>
<pre class="display">
<span class="plain">#</span><span class="identifier">include</span><span class="plain"> &lt;</span><span class="identifier">sys</span><span class="plain">/</span><span class="identifier">stat</span><span class="plain">.</span><span class="identifier">h</span><span class="plain">&gt;</span>
<span class="plain">#</span><span class="identifier">include</span><span class="plain"> &lt;</span><span class="identifier">dirent</span><span class="plain">.</span><span class="identifier">h</span><span class="plain">&gt;</span>
<span class="plain">#</span><span class="identifier">include</span><span class="plain"> &lt;</span><span class="identifier">errno</span><span class="plain">.</span><span class="identifier">h</span><span class="plain">&gt;</span>
<span class="plain">#</span><span class="identifier">include</span><span class="plain"> &lt;</span><span class="identifier">io</span><span class="plain">.</span><span class="identifier">h</span><span class="plain">&gt;</span>
<span class="plain">#</span><span class="identifier">include</span><span class="plain"> &lt;</span><span class="identifier">windows</span><span class="plain">.</span><span class="identifier">h</span><span class="plain">&gt;</span>
</pre>
<p class="inwebparagraph"></p>
<p class="endnote">This paragraph is used only if PLATFORM_WINDOWS is defined.</p>
<p class="inwebparagraph"><a id="SP3"></a><b>&#167;3. </b>A Windows-safe form of <code class="display"><span class="extract">isdigit</span></code>. Annoyingly, the C specification allows
the implementation to have <code class="display"><span class="extract">char</span></code> either signed or unsigned. On Windows it's
generally signed. Now, consider what happens with a character value of
acute-e. This has an <code class="display"><span class="extract">unsigned char</span></code> value of 233. When stored in a <code class="display"><span class="extract">char</span></code>
on Windows, this becomes a value of <code class="display"><span class="extract">-23</span></code>. When this is passed to <code class="display"><span class="extract">isdigit()</span></code>,
we need to consider the prototype for <code class="display"><span class="extract">isdigit()</span></code>:
</p>
<p class="inwebparagraph"><code class="display"><span class="extract">int isdigit(int);</span></code>
</p>
<p class="inwebparagraph">So, when casting to int we get <code class="display"><span class="extract">-23</span></code>, not <code class="display"><span class="extract">233</span></code>. Unfortunately the return value
from <code class="display"><span class="extract">isdigit()</span></code> is only defined by the C specification for values in the
range 0 to 255 (and also EOF), so the return value for <code class="display"><span class="extract">-23</span></code> is undefined.
And with Windows GCC, <code class="display"><span class="extract">isdigit(-23)</span></code> returns a non-zero value.
</p>
<pre class="definitions">
<span class="definitionkeyword">define</span> <span class="identifier">isdigit</span><span class="plain">(</span><span class="identifier">x</span><span class="plain">) </span><span class="functiontext"><a href="#SP3">Platform::Windows_isdigit</a></span><span class="plain">(</span><span class="identifier">x</span><span class="plain">)</span>
</pre>
<pre class="display">
<span class="reserved">int</span><span class="plain"> </span><span class="functiontext">Platform::Windows_isdigit<button class="popup" onclick="togglePopup('usagePopup5')">...<span class="popuptext" id="usagePopup5">Usage of <b>Platform::Windows_isdigit</b>:<br>none</span></button></span><span class="plain">(</span><span class="reserved">int</span><span class="plain"> </span><span class="identifier">c</span><span class="plain">) {</span>
<span class="reserved">return</span><span class="plain"> ((</span><span class="identifier">c</span><span class="plain"> &gt;= </span><span class="character">'0'</span><span class="plain">) &amp;&amp; (</span><span class="identifier">c</span><span class="plain"> &lt;= </span><span class="character">'9'</span><span class="plain">)) ? </span><span class="constant">1</span><span class="plain"> : </span><span class="constant">0</span><span class="plain">;</span>
<span class="plain">}</span>
</pre>
<p class="inwebparagraph"></p>
<p class="endnote">This paragraph is used only if PLATFORM_WINDOWS is defined.</p>
<p class="inwebparagraph"><a id="SP4"></a><b>&#167;4. Environment variables. </b></p>
<pre class="display">
<span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">__stdcall</span><span class="plain"> </span><span class="functiontext">GetCurrentDirectoryA<button class="popup" onclick="togglePopup('usagePopup6')">...<span class="popuptext" id="usagePopup6">Usage of <b>GetCurrentDirectoryA</b>:<br>none</span></button></span><span class="plain">(</span><span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">len</span><span class="plain">, </span><span class="reserved">char</span><span class="plain">* </span><span class="identifier">buffer</span><span class="plain">);</span>
<span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">__stdcall</span><span class="plain"> </span><span class="functiontext">SHGetFolderPathA<button class="popup" onclick="togglePopup('usagePopup7')">...<span class="popuptext" id="usagePopup7">Usage of <b>SHGetFolderPathA</b>:<br>none</span></button></span><span class="plain">(</span><span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">wnd</span><span class="plain">, </span><span class="reserved">int</span><span class="plain"> </span><span class="identifier">folder</span><span class="plain">,</span>
<span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">token</span><span class="plain">, </span><span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">flags</span><span class="plain">, </span><span class="reserved">char</span><span class="plain">* </span><span class="identifier">path</span><span class="plain">);</span>
<span class="reserved">char</span><span class="plain"> *</span><span class="functiontext">Platform::getenv<button class="popup" onclick="togglePopup('usagePopup8')">...<span class="popuptext" id="usagePopup8">Usage of <b>Platform::getenv</b>:<br>POSIX Platforms - <a href="1-pp.html#SP8">&#167;8</a><br>Pathnames - <a href="3-pth.html#SP2">&#167;2</a>, <a href="3-pth.html#SP3">&#167;3</a></span></button></span><span class="plain">(</span><span class="reserved">const</span><span class="plain"> </span><span class="reserved">char</span><span class="plain"> *</span><span class="identifier">name</span><span class="plain">) {</span>
<span class="reserved">static</span><span class="plain"> </span><span class="reserved">char</span><span class="plain"> </span><span class="identifier">env</span><span class="plain">[260];</span>
<span class="identifier">env</span><span class="plain">[0] = </span><span class="constant">0</span><span class="plain">;</span>
<span class="reserved">if</span><span class="plain"> (</span><span class="identifier">strcmp</span><span class="plain">(</span><span class="identifier">name</span><span class="plain">,</span><span class="string">"PWD"</span><span class="plain">) == </span><span class="constant">0</span><span class="plain">) {</span>
<span class="reserved">if</span><span class="plain"> (</span><span class="functiontext"><a href="#SP4">GetCurrentDirectoryA</a></span><span class="plain">(260,</span><span class="identifier">env</span><span class="plain">) &gt; </span><span class="constant">0</span><span class="plain">) </span><span class="reserved">return</span><span class="plain"> </span><span class="identifier">env</span><span class="plain">;</span>
<span class="plain">} </span><span class="reserved">else</span><span class="plain"> </span><span class="reserved">if</span><span class="plain"> (</span><span class="identifier">strcmp</span><span class="plain">(</span><span class="identifier">name</span><span class="plain">,</span><span class="string">"HOME"</span><span class="plain">) == </span><span class="constant">0</span><span class="plain">) {</span>
<span class="reserved">if</span><span class="plain"> (</span><span class="functiontext"><a href="#SP4">SHGetFolderPathA</a></span><span class="plain">(0,5,0,0,</span><span class="identifier">env</span><span class="plain">) == </span><span class="constant">0</span><span class="plain">) </span><span class="reserved">return</span><span class="plain"> </span><span class="identifier">env</span><span class="plain">;</span>
<span class="plain">}</span>
<span class="reserved">return</span><span class="plain"> </span><span class="identifier">getenv</span><span class="plain">(</span><span class="identifier">name</span><span class="plain">);</span>
<span class="plain">}</span>
</pre>
<p class="inwebparagraph"></p>
<p class="endnote">This paragraph is used only if PLATFORM_WINDOWS is defined.</p>
<p class="inwebparagraph"><a id="SP5"></a><b>&#167;5. Executable location. </b>Fill the wide-char buffer <code class="display"><span class="extract">p</span></code> with the path to the current executable, up to
length <code class="display"><span class="extract">length</span></code>. This function is guaranteed to be called from only one
thread. Should the information be unavailable, or fail to fit into <code class="display"><span class="extract">p</span></code>,
truncate <code class="display"><span class="extract">p</span></code> to zero length. (On some platforms, the information will
always be unavailable: that doesn't mean we can't run on those platforms,
just that installation and use of Foundation-built tools is less convenient.)
</p>
<pre class="display">
<span class="reserved">void</span><span class="plain"> </span><span class="functiontext">Platform::where_am_i<button class="popup" onclick="togglePopup('usagePopup9')">...<span class="popuptext" id="usagePopup9">Usage of <b>Platform::where_am_i</b>:<br>POSIX Platforms - <a href="1-pp.html#SP9">&#167;9</a>, <a href="1-pp.html#SP9_1_1">&#167;9.1.1</a>, <a href="1-pp.html#SP9_1_2">&#167;9.1.2</a>, <a href="1-pp.html#SP9_1_3">&#167;9.1.3</a><br>Pathnames - <a href="3-pth.html#SP3">&#167;3</a></span></button></span><span class="plain">(</span><span class="identifier">wchar_t</span><span class="plain"> *</span><span class="identifier">p</span><span class="plain">, </span><span class="identifier">size_t</span><span class="plain"> </span><span class="identifier">length</span><span class="plain">) {</span>
<span class="identifier">DWORD</span><span class="plain"> </span><span class="identifier">result</span><span class="plain"> = </span><span class="identifier">GetModuleFileNameW</span><span class="plain">(</span><span class="identifier">NULL</span><span class="plain">, </span><span class="identifier">p</span><span class="plain">, </span><span class="identifier">length</span><span class="plain">);</span>
<span class="reserved">if</span><span class="plain"> ((</span><span class="identifier">result</span><span class="plain"> == </span><span class="constant">0</span><span class="plain">) || (</span><span class="identifier">result</span><span class="plain"> == </span><span class="identifier">length</span><span class="plain">)) </span><span class="identifier">p</span><span class="plain">[0] = </span><span class="constant">0</span><span class="plain">;</span>
<span class="plain">}</span>
</pre>
<p class="inwebparagraph"></p>
<p class="endnote">This paragraph is used only if PLATFORM_WINDOWS is defined.</p>
<p class="inwebparagraph"><a id="SP6"></a><b>&#167;6. Shell commands. </b></p>
<pre class="display">
<span class="reserved">struct</span><span class="plain"> </span><span class="identifier">Win32_Startup_Info</span><span class="plain"> {</span>
<span class="reserved">long</span><span class="plain"> </span><span class="identifier">v1</span><span class="plain">; </span><span class="reserved">char</span><span class="plain">* </span><span class="identifier">v2</span><span class="plain">; </span><span class="reserved">char</span><span class="plain">* </span><span class="identifier">v3</span><span class="plain">; </span><span class="reserved">char</span><span class="plain">* </span><span class="identifier">v4</span><span class="plain">; </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">v5</span><span class="plain">; </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">v6</span><span class="plain">;</span>
<span class="reserved">long</span><span class="plain"> </span><span class="identifier">v7</span><span class="plain">; </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">v8</span><span class="plain">; </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">v9</span><span class="plain">; </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">v10</span><span class="plain">; </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">v11</span><span class="plain">;</span>
<span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">flags</span><span class="plain">; </span><span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">short</span><span class="plain"> </span><span class="identifier">showWindow</span><span class="plain">;</span>
<span class="reserved">short</span><span class="plain"> </span><span class="identifier">v12</span><span class="plain">; </span><span class="reserved">char</span><span class="plain">* </span><span class="identifier">v13</span><span class="plain">; </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">v14</span><span class="plain">; </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">v15</span><span class="plain">; </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">v16</span><span class="plain">; };</span>
<span class="reserved">struct</span><span class="plain"> </span><span class="identifier">Win32_Process_Info</span><span class="plain"> {</span>
<span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">process</span><span class="plain">; </span><span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">thread</span><span class="plain">; </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">v1</span><span class="plain">; </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">v2</span><span class="plain">; };</span>
<span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">__stdcall</span><span class="plain"> </span><span class="functiontext">CloseHandle<button class="popup" onclick="togglePopup('usagePopup10')">...<span class="popuptext" id="usagePopup10">Usage of <b>CloseHandle</b>:<br>none</span></button></span><span class="plain">(</span><span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">handle</span><span class="plain">);</span>
<span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">__stdcall</span><span class="plain"> </span><span class="functiontext">WaitForSingleObject<button class="popup" onclick="togglePopup('usagePopup11')">...<span class="popuptext" id="usagePopup11">Usage of <b>WaitForSingleObject</b>:<br><a href="#SP11">&#167;11</a></span></button></span><span class="plain">(</span><span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">handle</span><span class="plain">, </span><span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">ms</span><span class="plain">);</span>
<span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">__stdcall</span><span class="plain"> </span><span class="functiontext">CreateProcessA<button class="popup" onclick="togglePopup('usagePopup12')">...<span class="popuptext" id="usagePopup12">Usage of <b>CreateProcessA</b>:<br>none</span></button></span><span class="plain">(</span><span class="reserved">void</span><span class="plain">* </span><span class="identifier">app</span><span class="plain">, </span><span class="reserved">char</span><span class="plain">* </span><span class="identifier">cmd</span><span class="plain">, </span><span class="reserved">void</span><span class="plain">* </span><span class="identifier">pa</span><span class="plain">,</span>
<span class="reserved">void</span><span class="plain">* </span><span class="identifier">ta</span><span class="plain">, </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">inherit</span><span class="plain">, </span><span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">flags</span><span class="plain">, </span><span class="reserved">void</span><span class="plain">* </span><span class="identifier">env</span><span class="plain">, </span><span class="reserved">void</span><span class="plain">* </span><span class="identifier">dir</span><span class="plain">,</span>
<span class="reserved">struct</span><span class="plain"> </span><span class="identifier">Win32_Startup_Info</span><span class="plain">* </span><span class="identifier">start</span><span class="plain">, </span><span class="reserved">struct</span><span class="plain"> </span><span class="identifier">Win32_Process_Info</span><span class="plain">* </span><span class="identifier">process</span><span class="plain">);</span>
<span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">__stdcall</span><span class="plain"> </span><span class="functiontext">GetExitCodeProcess<button class="popup" onclick="togglePopup('usagePopup13')">...<span class="popuptext" id="usagePopup13">Usage of <b>GetExitCodeProcess</b>:<br>none</span></button></span><span class="plain">(</span><span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">proc</span><span class="plain">, </span><span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain">* </span><span class="identifier">code</span><span class="plain">);</span>
<span class="reserved">int</span><span class="plain"> </span><span class="functiontext">Platform::system<button class="popup" onclick="togglePopup('usagePopup14')">...<span class="popuptext" id="usagePopup14">Usage of <b>Platform::system</b>:<br>POSIX Platforms - <a href="1-pp.html#SP10">&#167;10</a>, <a href="1-pp.html#SP11">&#167;11</a>, <a href="1-pp.html#SP14">&#167;14</a><br>Shell - <a href="3-shl.html#SP5">&#167;5</a></span></button></span><span class="plain">(</span><span class="reserved">const</span><span class="plain"> </span><span class="reserved">char</span><span class="plain"> *</span><span class="identifier">cmd</span><span class="plain">) {</span>
<span class="reserved">if</span><span class="plain"> (</span><span class="identifier">strncmp</span><span class="plain">(</span><span class="identifier">cmd</span><span class="plain">,</span><span class="string">"md5 "</span><span class="plain">, </span><span class="constant">4</span><span class="plain">) == </span><span class="constant">0</span><span class="plain">) </span><span class="reserved">return</span><span class="plain"> </span><span class="constant">0</span><span class="plain">;</span>
<span class="reserved">char</span><span class="plain"> </span><span class="identifier">cmdline</span><span class="plain">[4096];</span>
<span class="identifier">sprintf</span><span class="plain">(</span><span class="identifier">cmdline</span><span class="plain">,</span><span class="string">"cmd /s /c \"%s\""</span><span class="plain">, </span><span class="identifier">cmd</span><span class="plain">);</span>
<span class="reserved">struct</span><span class="plain"> </span><span class="identifier">Win32_Startup_Info</span><span class="plain"> </span><span class="identifier">start</span><span class="plain"> = { </span><span class="reserved">sizeof</span><span class="plain"> (</span><span class="reserved">struct</span><span class="plain"> </span><span class="identifier">Win32_Startup_Info</span><span class="plain">), </span><span class="constant">0</span><span class="plain"> };</span>
<span class="identifier">start</span><span class="plain">.</span><span class="identifier">flags</span><span class="plain"> = </span><span class="constant">1</span><span class="plain">;</span>
<span class="identifier">start</span><span class="plain">.</span><span class="identifier">showWindow</span><span class="plain"> = </span><span class="constant">0</span><span class="plain">;</span>
<span class="reserved">struct</span><span class="plain"> </span><span class="identifier">Win32_Process_Info</span><span class="plain"> </span><span class="identifier">process</span><span class="plain">;</span>
<span class="reserved">if</span><span class="plain"> (</span><span class="functiontext"><a href="#SP6">CreateProcessA</a></span><span class="plain">(0, </span><span class="identifier">cmdline</span><span class="plain">, </span><span class="constant">0</span><span class="plain">, </span><span class="constant">0</span><span class="plain">, </span><span class="constant">0</span><span class="plain">, </span><span class="constant">0x8000000</span><span class="plain">, </span><span class="constant">0</span><span class="plain">, </span><span class="constant">0</span><span class="plain">, &amp;</span><span class="identifier">start</span><span class="plain">, &amp;</span><span class="identifier">process</span><span class="plain">) == </span><span class="constant">0</span><span class="plain">)</span>
<span class="reserved">return</span><span class="plain"> -1;</span>
<span class="functiontext"><a href="#SP6">CloseHandle</a></span><span class="plain">(</span><span class="identifier">process</span><span class="plain">.</span><span class="identifier">thread</span><span class="plain">);</span>
<span class="reserved">if</span><span class="plain"> (</span><span class="functiontext"><a href="#SP6">WaitForSingleObject</a></span><span class="plain">(</span><span class="identifier">process</span><span class="plain">.</span><span class="identifier">process</span><span class="plain">, -1) != </span><span class="constant">0</span><span class="plain">) {</span>
<span class="functiontext"><a href="#SP6">CloseHandle</a></span><span class="plain">(</span><span class="identifier">process</span><span class="plain">.</span><span class="identifier">process</span><span class="plain">);</span>
<span class="reserved">return</span><span class="plain"> -1;</span>
<span class="plain">}</span>
<span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">code</span><span class="plain"> = </span><span class="constant">10</span><span class="plain">;</span>
<span class="functiontext"><a href="#SP6">GetExitCodeProcess</a></span><span class="plain">(</span><span class="identifier">process</span><span class="plain">.</span><span class="identifier">process</span><span class="plain">, &amp;</span><span class="identifier">code</span><span class="plain">);</span>
<span class="functiontext"><a href="#SP6">CloseHandle</a></span><span class="plain">(</span><span class="identifier">process</span><span class="plain">.</span><span class="identifier">process</span><span class="plain">);</span>
<span class="reserved">return</span><span class="plain"> </span><span class="identifier">code</span><span class="plain">;</span>
<span class="plain">}</span>
</pre>
<p class="inwebparagraph"></p>
<p class="endnote">This paragraph is used only if PLATFORM_WINDOWS is defined.</p>
<p class="inwebparagraph"><a id="SP7"></a><b>&#167;7. Directory handling. </b></p>
<pre class="display">
<span class="reserved">int</span><span class="plain"> </span><span class="functiontext">Platform::mkdir<button class="popup" onclick="togglePopup('usagePopup15')">...<span class="popuptext" id="usagePopup15">Usage of <b>Platform::mkdir</b>:<br>POSIX Platforms - <a href="1-pp.html#SP12">&#167;12</a><br>Pathnames - <a href="3-pth.html#SP8">&#167;8</a></span></button></span><span class="plain">(</span><span class="reserved">char</span><span class="plain"> *</span><span class="identifier">transcoded_pathname</span><span class="plain">) {</span>
<span class="identifier">errno</span><span class="plain"> = </span><span class="constant">0</span><span class="plain">;</span>
<span class="reserved">int</span><span class="plain"> </span><span class="identifier">rv</span><span class="plain"> = </span><span class="identifier">_mkdir</span><span class="plain">(</span><span class="identifier">transcoded_pathname</span><span class="plain">);</span>
<span class="reserved">if</span><span class="plain"> (</span><span class="identifier">rv</span><span class="plain"> == </span><span class="constant">0</span><span class="plain">) </span><span class="reserved">return</span><span class="plain"> </span><span class="constant">TRUE</span><span class="plain">;</span>
<span class="reserved">if</span><span class="plain"> (</span><span class="identifier">errno</span><span class="plain"> == </span><span class="identifier">EEXIST</span><span class="plain">) </span><span class="reserved">return</span><span class="plain"> </span><span class="constant">TRUE</span><span class="plain">;</span>
<span class="reserved">return</span><span class="plain"> </span><span class="constant">FALSE</span><span class="plain">;</span>
<span class="plain">}</span>
<span class="reserved">void</span><span class="plain"> *</span><span class="functiontext">Platform::opendir<button class="popup" onclick="togglePopup('usagePopup16')">...<span class="popuptext" id="usagePopup16">Usage of <b>Platform::opendir</b>:<br>POSIX Platforms - <a href="1-pp.html#SP12">&#167;12</a><br>Directories - <a href="3-drc.html#SP2">&#167;2</a></span></button></span><span class="plain">(</span><span class="reserved">char</span><span class="plain"> *</span><span class="identifier">path_to_folder</span><span class="plain">) {</span>
<span class="identifier">DIR</span><span class="plain"> *</span><span class="identifier">dirp</span><span class="plain"> = </span><span class="identifier">opendir</span><span class="plain">(</span><span class="identifier">path_to_folder</span><span class="plain">);</span>
<span class="reserved">return</span><span class="plain"> (</span><span class="reserved">void</span><span class="plain"> *) </span><span class="identifier">dirp</span><span class="plain">;</span>
<span class="plain">}</span>
<span class="reserved">int</span><span class="plain"> </span><span class="functiontext">Platform::readdir<button class="popup" onclick="togglePopup('usagePopup17')">...<span class="popuptext" id="usagePopup17">Usage of <b>Platform::readdir</b>:<br>POSIX Platforms - <a href="1-pp.html#SP12">&#167;12</a><br>Directories - <a href="3-drc.html#SP2">&#167;2</a></span></button></span><span class="plain">(</span><span class="reserved">void</span><span class="plain"> *</span><span class="identifier">folder</span><span class="plain">, </span><span class="reserved">char</span><span class="plain"> *</span><span class="identifier">path_to_folder</span><span class="plain">,</span>
<span class="reserved">char</span><span class="plain"> *</span><span class="identifier">leafname</span><span class="plain">) {</span>
<span class="reserved">char</span><span class="plain"> </span><span class="identifier">path_to</span><span class="plain">[2*</span><span class="constant">MAX_FILENAME_LENGTH</span><span class="plain">+2];</span>
<span class="reserved">struct</span><span class="plain"> </span><span class="identifier">_stat</span><span class="plain"> </span><span class="identifier">file_status</span><span class="plain">;</span>
<span class="reserved">int</span><span class="plain"> </span><span class="identifier">rv</span><span class="plain">;</span>
<span class="identifier">DIR</span><span class="plain"> *</span><span class="identifier">dirp</span><span class="plain"> = (</span><span class="identifier">DIR</span><span class="plain"> *) </span><span class="identifier">folder</span><span class="plain">;</span>
<span class="reserved">struct</span><span class="plain"> </span><span class="identifier">dirent</span><span class="plain"> *</span><span class="identifier">dp</span><span class="plain">;</span>
<span class="reserved">if</span><span class="plain"> ((</span><span class="identifier">dp</span><span class="plain"> = </span><span class="identifier">readdir</span><span class="plain">(</span><span class="identifier">dirp</span><span class="plain">)) == </span><span class="identifier">NULL</span><span class="plain">) </span><span class="reserved">return</span><span class="plain"> </span><span class="constant">FALSE</span><span class="plain">;</span>
<span class="identifier">sprintf</span><span class="plain">(</span><span class="identifier">path_to</span><span class="plain">, </span><span class="string">"%s%c%s"</span><span class="plain">, </span><span class="identifier">path_to_folder</span><span class="plain">, </span><span class="constant">FOLDER_SEPARATOR</span><span class="plain">, </span><span class="identifier">dp</span><span class="plain">-&gt;</span><span class="identifier">d_name</span><span class="plain">);</span>
<span class="identifier">rv</span><span class="plain"> = </span><span class="identifier">_stat</span><span class="plain">(</span><span class="identifier">path_to</span><span class="plain">, &amp;</span><span class="identifier">file_status</span><span class="plain">);</span>
<span class="reserved">if</span><span class="plain"> (</span><span class="identifier">rv</span><span class="plain"> != </span><span class="constant">0</span><span class="plain">) </span><span class="reserved">return</span><span class="plain"> </span><span class="constant">FALSE</span><span class="plain">;</span>
<span class="reserved">if</span><span class="plain"> (</span><span class="identifier">S_ISDIR</span><span class="plain">(</span><span class="identifier">file_status</span><span class="plain">.</span><span class="identifier">st_mode</span><span class="plain">))</span>
<span class="identifier">sprintf</span><span class="plain">(</span><span class="identifier">leafname</span><span class="plain">, </span><span class="string">"%s%c"</span><span class="plain">, </span><span class="identifier">dp</span><span class="plain">-&gt;</span><span class="identifier">d_name</span><span class="plain">, </span><span class="constant">FOLDER_SEPARATOR</span><span class="plain">);</span>
<span class="reserved">else</span><span class="plain"> </span><span class="identifier">strcpy</span><span class="plain">(</span><span class="identifier">leafname</span><span class="plain">, </span><span class="identifier">dp</span><span class="plain">-&gt;</span><span class="identifier">d_name</span><span class="plain">);</span>
<span class="reserved">return</span><span class="plain"> </span><span class="constant">TRUE</span><span class="plain">;</span>
<span class="plain">}</span>
<span class="reserved">void</span><span class="plain"> </span><span class="functiontext">Platform::closedir<button class="popup" onclick="togglePopup('usagePopup18')">...<span class="popuptext" id="usagePopup18">Usage of <b>Platform::closedir</b>:<br>POSIX Platforms - <a href="1-pp.html#SP12">&#167;12</a><br>Directories - <a href="3-drc.html#SP2">&#167;2</a></span></button></span><span class="plain">(</span><span class="reserved">void</span><span class="plain"> *</span><span class="identifier">folder</span><span class="plain">) {</span>
<span class="identifier">DIR</span><span class="plain"> *</span><span class="identifier">dirp</span><span class="plain"> = (</span><span class="identifier">DIR</span><span class="plain"> *) </span><span class="identifier">folder</span><span class="plain">;</span>
<span class="identifier">closedir</span><span class="plain">(</span><span class="identifier">dirp</span><span class="plain">);</span>
<span class="plain">}</span>
</pre>
<p class="inwebparagraph"></p>
<p class="endnote">This paragraph is used only if PLATFORM_WINDOWS is defined.</p>
<p class="inwebparagraph"><a id="SP8"></a><b>&#167;8. Sleep. </b>The Windows <code class="display"><span class="extract">Sleep</span></code> call measures time in milliseconds, whereas
POSIX <code class="display"><span class="extract">sleep</span></code> is for seconds.
</p>
<pre class="display">
<span class="reserved">void</span><span class="plain"> </span><span class="identifier">__stdcall</span><span class="plain"> </span><span class="identifier">Sleep</span><span class="plain">(</span><span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">ms</span><span class="plain">);</span>
<span class="reserved">void</span><span class="plain"> </span><span class="functiontext">Platform::sleep<button class="popup" onclick="togglePopup('usagePopup19')">...<span class="popuptext" id="usagePopup19">Usage of <b>Platform::sleep</b>:<br>POSIX Platforms - <a href="1-pp.html#SP15">&#167;15</a></span></button></span><span class="plain">(</span><span class="reserved">int</span><span class="plain"> </span><span class="identifier">seconds</span><span class="plain">) {</span>
<span class="identifier">Sleep</span><span class="plain">((</span><span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain">) </span><span class="constant">1000</span><span class="plain">*</span><span class="identifier">seconds</span><span class="plain">);</span>
<span class="plain">}</span>
</pre>
<p class="inwebparagraph"></p>
<p class="endnote">This paragraph is used only if PLATFORM_WINDOWS is defined.</p>
<p class="inwebparagraph"><a id="SP9"></a><b>&#167;9. Notifications. </b></p>
<pre class="display">
<span class="reserved">void</span><span class="plain"> </span><span class="functiontext">Platform::notification<button class="popup" onclick="togglePopup('usagePopup20')">...<span class="popuptext" id="usagePopup20">Usage of <b>Platform::notification</b>:<br>POSIX Platforms - <a href="1-pp.html#SP16">&#167;16</a>, <a href="1-pp.html#SP17">&#167;17</a></span></button></span><span class="plain">(</span><span class="reserved">text_stream</span><span class="plain"> *</span><span class="identifier">text</span><span class="plain">, </span><span class="reserved">int</span><span class="plain"> </span><span class="identifier">happy</span><span class="plain">) {</span>
<span class="plain">}</span>
</pre>
<p class="inwebparagraph"></p>
<p class="endnote">This paragraph is used only if PLATFORM_WINDOWS is defined.</p>
<p class="inwebparagraph"><a id="SP10"></a><b>&#167;10. Concurrency. </b>The following predeclarations come from the Windows SDK.
</p>
<pre class="display">
<span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">__stdcall</span><span class="plain"> </span><span class="functiontext">CreateThread<button class="popup" onclick="togglePopup('usagePopup21')">...<span class="popuptext" id="usagePopup21">Usage of <b>CreateThread</b>:<br><a href="#SP11">&#167;11</a></span></button></span><span class="plain">(</span><span class="reserved">void</span><span class="plain">* </span><span class="identifier">attrs</span><span class="plain">, </span><span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">stack</span><span class="plain">,</span>
<span class="reserved">void</span><span class="plain">* </span><span class="identifier">func</span><span class="plain">, </span><span class="reserved">void</span><span class="plain">* </span><span class="identifier">param</span><span class="plain">, </span><span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">flags</span><span class="plain">, </span><span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain">* </span><span class="identifier">id</span><span class="plain">);</span>
<span class="reserved">struct</span><span class="plain"> </span><span class="identifier">Win32_Thread_Attrs</span><span class="plain"> {};</span>
<span class="reserved">struct</span><span class="plain"> </span><span class="identifier">Win32_Thread_Start</span><span class="plain"> { </span><span class="reserved">void</span><span class="plain"> *(*</span><span class="identifier">fn</span><span class="plain">)(</span><span class="reserved">void</span><span class="plain"> *); </span><span class="reserved">void</span><span class="plain">* </span><span class="identifier">arg</span><span class="plain">; };</span>
<span class="reserved">typedef</span><span class="plain"> </span><span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">foundation_thread</span><span class="plain">;</span>
<span class="reserved">typedef</span><span class="plain"> </span><span class="reserved">struct</span><span class="plain"> </span><span class="identifier">Win32_Thread_Attrs</span><span class="plain"> </span><span class="identifier">foundation_thread_attributes</span><span class="plain">;</span>
</pre>
<p class="inwebparagraph"></p>
<p class="endnote">This paragraph is used only if PLATFORM_WINDOWS is defined.</p>
<p class="inwebparagraph"><a id="SP11"></a><b>&#167;11. </b></p>
<pre class="display">
<span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">__stdcall</span><span class="plain"> </span><span class="functiontext">Platform::Win32_Thread_Func<button class="popup" onclick="togglePopup('usagePopup22')">...<span class="popuptext" id="usagePopup22">Usage of <b>Platform::Win32_Thread_Func</b>:<br>none</span></button></span><span class="plain">(</span><span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">param</span><span class="plain">) {</span>
<span class="reserved">struct</span><span class="plain"> </span><span class="identifier">Win32_Thread_Start</span><span class="plain">* </span><span class="identifier">start</span><span class="plain"> = (</span><span class="reserved">struct</span><span class="plain"> </span><span class="identifier">Win32_Thread_Start</span><span class="plain">*)</span><span class="identifier">param</span><span class="plain">;</span>
<span class="plain">(</span><span class="identifier">start</span><span class="plain">-&gt;</span><span class="identifier">fn</span><span class="plain">)(</span><span class="identifier">start</span><span class="plain">-&gt;</span><span class="identifier">arg</span><span class="plain">);</span>
<span class="identifier">free</span><span class="plain">(</span><span class="identifier">start</span><span class="plain">);</span>
<span class="reserved">return</span><span class="plain"> </span><span class="constant">0</span><span class="plain">;</span>
<span class="plain">}</span>
<span class="reserved">int</span><span class="plain"> </span><span class="functiontext">Platform::create_thread<button class="popup" onclick="togglePopup('usagePopup23')">...<span class="popuptext" id="usagePopup23">Usage of <b>Platform::create_thread</b>:<br>POSIX Platforms - <a href="1-pp.html#SP19">&#167;19</a></span></button></span><span class="plain">(</span><span class="identifier">foundation_thread</span><span class="plain"> *</span><span class="identifier">pt</span><span class="plain">, </span><span class="reserved">const</span><span class="plain"> </span><span class="identifier">foundation_thread_attributes</span><span class="plain"> *</span><span class="identifier">pa</span><span class="plain">,</span>
<span class="reserved">void</span><span class="plain"> *(*</span><span class="identifier">fn</span><span class="plain">)(</span><span class="reserved">void</span><span class="plain"> *), </span><span class="reserved">void</span><span class="plain"> *</span><span class="identifier">arg</span><span class="plain">) {</span>
<span class="reserved">struct</span><span class="plain"> </span><span class="identifier">Win32_Thread_Start</span><span class="plain">* </span><span class="identifier">start</span><span class="plain"> = (</span><span class="reserved">struct</span><span class="plain"> </span><span class="identifier">Win32_Thread_Start</span><span class="plain">*) </span><span class="identifier">malloc</span><span class="plain">(</span><span class="reserved">sizeof</span><span class="plain"> (</span><span class="reserved">struct</span><span class="plain"> </span><span class="identifier">Win32_Thread_Start</span><span class="plain">));</span>
<span class="identifier">start</span><span class="plain">-&gt;</span><span class="identifier">fn</span><span class="plain"> = </span><span class="identifier">fn</span><span class="plain">;</span>
<span class="identifier">start</span><span class="plain">-&gt;</span><span class="identifier">arg</span><span class="plain"> = </span><span class="identifier">arg</span><span class="plain">;</span>
<span class="reserved">unsigned</span><span class="plain"> </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">thread</span><span class="plain"> = </span><span class="functiontext"><a href="#SP10">CreateThread</a></span><span class="plain">(0,0,</span><span class="functiontext"><a href="#SP11">Platform::Win32_Thread_Func</a></span><span class="plain">,</span><span class="identifier">start</span><span class="plain">,0,0);</span>
<span class="reserved">if</span><span class="plain"> (</span><span class="identifier">thread</span><span class="plain"> == </span><span class="constant">0</span><span class="plain">) {</span>
<span class="identifier">free</span><span class="plain">(</span><span class="identifier">start</span><span class="plain">);</span>
<span class="reserved">return</span><span class="plain"> </span><span class="constant">1</span><span class="plain">;</span>
<span class="plain">} </span><span class="reserved">else</span><span class="plain"> {</span>
<span class="plain">*</span><span class="identifier">pt</span><span class="plain"> = </span><span class="identifier">thread</span><span class="plain">;</span>
<span class="reserved">return</span><span class="plain"> </span><span class="constant">0</span><span class="plain">;</span>
<span class="plain">}</span>
<span class="plain">}</span>
<span class="reserved">int</span><span class="plain"> </span><span class="functiontext">Platform::join_thread<button class="popup" onclick="togglePopup('usagePopup24')">...<span class="popuptext" id="usagePopup24">Usage of <b>Platform::join_thread</b>:<br>POSIX Platforms - <a href="1-pp.html#SP19">&#167;19</a></span></button></span><span class="plain">(</span><span class="identifier">pthread_t</span><span class="plain"> </span><span class="identifier">pt</span><span class="plain">, </span><span class="reserved">void</span><span class="plain">** </span><span class="identifier">rv</span><span class="plain">) {</span>
<span class="reserved">return</span><span class="plain"> (</span><span class="functiontext"><a href="#SP6">WaitForSingleObject</a></span><span class="plain">(</span><span class="identifier">pt</span><span class="plain">,-1) == </span><span class="constant">0</span><span class="plain">) ? </span><span class="constant">0</span><span class="plain"> : </span><span class="constant">1</span><span class="plain">;</span>
<span class="plain">}</span>
<span class="reserved">void</span><span class="plain"> </span><span class="functiontext">Platform::init_thread<button class="popup" onclick="togglePopup('usagePopup25')">...<span class="popuptext" id="usagePopup25">Usage of <b>Platform::init_thread</b>:<br>POSIX Platforms - <a href="1-pp.html#SP19">&#167;19</a></span></button></span><span class="plain">(</span><span class="identifier">pthread_attr_t</span><span class="plain">* </span><span class="identifier">pa</span><span class="plain">, </span><span class="identifier">size_t</span><span class="plain"> </span><span class="identifier">size</span><span class="plain">) {</span>
<span class="plain">}</span>
<span class="identifier">size_t</span><span class="plain"> </span><span class="functiontext">Platform::get_thread_stack_size<button class="popup" onclick="togglePopup('usagePopup26')">...<span class="popuptext" id="usagePopup26">Usage of <b>Platform::get_thread_stack_size</b>:<br>POSIX Platforms - <a href="1-pp.html#SP19">&#167;19</a></span></button></span><span class="plain">(</span><span class="identifier">pthread_attr_t</span><span class="plain">* </span><span class="identifier">pa</span><span class="plain">) {</span>
<span class="reserved">return</span><span class="plain"> </span><span class="constant">0</span><span class="plain">;</span>
<span class="plain">}</span>
</pre>
<p class="inwebparagraph"></p>
<p class="endnote">This paragraph is used only if PLATFORM_WINDOWS is defined.</p>
<p class="inwebparagraph"><a id="SP12"></a><b>&#167;12. Timestamp. </b>There are implementations of the C standard library where <code class="display"><span class="extract">time_t</span></code> has
super-weird behaviour, but on almost POSIX systems, time 0 corresponds to
midnight on 1 January 1970. All we really need is that the "never" value
is one which is earlier than any possible timestamp on the files we'll
be dealing with.
</p>
<pre class="display">
<span class="identifier">time_t</span><span class="plain"> </span><span class="functiontext">Platform::never_time<button class="popup" onclick="togglePopup('usagePopup27')">...<span class="popuptext" id="usagePopup27">Usage of <b>Platform::never_time</b>:<br>POSIX Platforms - <a href="1-pp.html#SP13">&#167;13</a></span></button></span><span class="plain">(</span><span class="reserved">void</span><span class="plain">) {</span>
<span class="reserved">return</span><span class="plain"> (</span><span class="identifier">time_t</span><span class="plain">) </span><span class="constant">0</span><span class="plain">;</span>
<span class="plain">}</span>
<span class="identifier">time_t</span><span class="plain"> </span><span class="functiontext">Platform::timestamp<button class="popup" onclick="togglePopup('usagePopup28')">...<span class="popuptext" id="usagePopup28">Usage of <b>Platform::timestamp</b>:<br>POSIX Platforms - <a href="1-pp.html#SP13">&#167;13</a><br>Filenames - <a href="3-fln.html#SP12">&#167;12</a></span></button></span><span class="plain">(</span><span class="reserved">char</span><span class="plain"> *</span><span class="identifier">transcoded_filename</span><span class="plain">) {</span>
<span class="reserved">struct</span><span class="plain"> </span><span class="identifier">stat</span><span class="plain"> </span><span class="identifier">filestat</span><span class="plain">;</span>
<span class="reserved">if</span><span class="plain"> (</span><span class="identifier">stat</span><span class="plain">(</span><span class="identifier">transcoded_pathname</span><span class="plain">, &amp;</span><span class="identifier">filestat</span><span class="plain">) != -1) </span><span class="reserved">return</span><span class="plain"> </span><span class="identifier">filestat</span><span class="plain">.</span><span class="identifier">st_mtime</span><span class="plain">;</span>
<span class="reserved">return</span><span class="plain"> </span><span class="functiontext"><a href="#SP12">Platform::never_time</a></span><span class="plain">();</span>
<span class="plain">}</span>
</pre>
<p class="inwebparagraph"></p>
<p class="endnote">This paragraph is used only if PLATFORM_WINDOWS is defined.</p>
<p class="inwebparagraph"><a id="SP13"></a><b>&#167;13. Mutexes. </b></p>
<pre class="definitions">
<span class="definitionkeyword">define</span> <span class="identifier">CREATE_MUTEX</span><span class="plain">(</span><span class="identifier">name</span><span class="plain">)</span>
<span class="reserved">struct</span><span class="plain"> </span><span class="identifier">Win32_Critical_Section</span><span class="plain"> </span><span class="identifier">name</span><span class="plain"> { (</span><span class="reserved">void</span><span class="plain">*)-1, -1, </span><span class="constant">0</span><span class="plain">, </span><span class="constant">0</span><span class="plain">, </span><span class="constant">0</span><span class="plain">, </span><span class="constant">0</span><span class="plain"> };</span>
<span class="definitionkeyword">define</span> <span class="identifier">LOCK_MUTEX</span><span class="plain">(</span><span class="identifier">name</span><span class="plain">) </span><span class="identifier">EnterCriticalSection</span><span class="plain">(&amp;</span><span class="identifier">name</span><span class="plain">);</span>
<span class="definitionkeyword">define</span> <span class="identifier">UNLOCK_MUTEX</span><span class="plain">(</span><span class="identifier">name</span><span class="plain">) </span><span class="identifier">LeaveCriticalSection</span><span class="plain">(&amp;</span><span class="identifier">name</span><span class="plain">);</span>
</pre>
<pre class="display">
<span class="reserved">struct</span><span class="plain"> </span><span class="identifier">Win32_Critical_Section</span><span class="plain"> {</span>
<span class="reserved">void</span><span class="plain">* </span><span class="identifier">v1</span><span class="plain">; </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">v2</span><span class="plain">; </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">v3</span><span class="plain">; </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">v4</span><span class="plain">; </span><span class="reserved">long</span><span class="plain"> </span><span class="identifier">v5</span><span class="plain">; </span><span class="reserved">void</span><span class="plain">* </span><span class="identifier">v6</span><span class="plain">; };</span>
<span class="reserved">void</span><span class="plain"> </span><span class="identifier">__stdcall</span><span class="plain"> </span><span class="identifier">EnterCriticalSection</span><span class="plain">(</span><span class="reserved">struct</span><span class="plain"> </span><span class="identifier">Win32_Critical_Section</span><span class="plain">* </span><span class="identifier">cs</span><span class="plain">);</span>
<span class="reserved">void</span><span class="plain"> </span><span class="identifier">__stdcall</span><span class="plain"> </span><span class="identifier">LeaveCriticalSection</span><span class="plain">(</span><span class="reserved">struct</span><span class="plain"> </span><span class="identifier">Win32_Critical_Section</span><span class="plain">* </span><span class="identifier">cs</span><span class="plain">);</span>
</pre>
<p class="inwebparagraph"></p>
<p class="endnote">This paragraph is used only if PLATFORM_WINDOWS is defined.</p>
<hr class="tocbar">
<ul class="toc"><li><a href="1-pp.html">Back to 'POSIX Platforms'</a></li><li><i>(This section ends Chapter 1: Setting Up.)</i></li></ul><hr class="tocbar">
<!--End of weave-->
<script>
function togglePopup(material_id) {
var popup = document.getElementById(material_id);
popup.classList.toggle("show");
}
</script>
<link href="Popups.css" rel="stylesheet" rev="stylesheet" type="text/css">
</main>
</body>
</html>
Reference in a new issue View git blame Copy permalink