aboutsummaryrefslogtreecommitdiff
path: root/docs/doxygen/nel/sound__driver_8cpp-source.html
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--docs/doxygen/nel/sound__driver_8cpp-source.html206
1 files changed, 206 insertions, 0 deletions
diff --git a/docs/doxygen/nel/sound__driver_8cpp-source.html b/docs/doxygen/nel/sound__driver_8cpp-source.html
new file mode 100644
index 00000000..9e1d5b1d
--- /dev/null
+++ b/docs/doxygen/nel/sound__driver_8cpp-source.html
@@ -0,0 +1,206 @@
+<!doctype html public "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
+<HTML>
+<HEAD>
+ <TITLE>nevrax.org : docs</TITLE>
+ <LINK REL=stylesheet TYPE="text/css" HREF="http://www.nevrax.org/inc/css/nevrax.css">
+ <link href="doxygen.css" rel="stylesheet" type="text/css">
+</HEAD>
+<BODY MARGINHEIGHT="0" MARGINWIDTH="0">
+
+<!-- uplinks -->
+<TABLE CELLSPACING=0 CELLPADDING=0 BORDER=0>
+ <TR>
+ <TD WIDTH=16><IMG SRC="http://www.nevrax.org/inc/img/pixel.gif" WIDTH="16" HEIGHT="16" BORDER=0 ALT=""></TD>
+ <TD WIDTH=140 BGCOLOR=#dddddd><IMG SRC="http://www.nevrax.org/inc/img/pixel.gif" WIDTH="140" HEIGHT="16" BORDER=0 ALT=""></TD>
+ <TD WIDTH=16><IMG SRC="http://www.nevrax.org/inc/img/pixel.gif" WIDTH="16" HEIGHT="16" BORDER=0 ALT=""></TD>
+ <TD><IMG width=6 height=14 SRC="http://www.nevrax.org/inc/img/reddots.gif" ALT="#" VSPACE=2 HSPACE=2 BORDER=0 ></TD><TD VALIGN=middle>&nbsp;<A CLASS=uplinks HREF=http://www.nevrax.org><b>Home</B></FONT></A>&nbsp;&nbsp;&nbsp;</TD>
+ <TD><IMG width=6 height=14 SRC="http://www.nevrax.org/inc/img/reddots.gif" ALT="#" VSPACE=2 HSPACE=2 BORDER=0 ></TD><TD VALIGN=middle>&nbsp;<A CLASS=uplinks HREF=http://www.nevrax.com><b>nevrax.com</B></FONT></A>&nbsp;&nbsp;&nbsp;</TD>
+ </TR>
+</TABLE>
+
+<!-- banner Nevrax -->
+<TABLE CELLSPACING=0 CELLPADDING=0 BORDER=0 WIDTH=100%>
+ <TR><TD BGCOLOR="#000000" BACKGROUND="http://www.nevrax.org/inc/img/black_banner.jpg"><A HREF="http://www.nevrax.org"><IMG SRC="http://www.nevrax.org/inc/img/nevrax.gif" WIDTH="170" HEIGHT="45" BORDER=0 ALT="Nevrax" ></A></TD></TR>
+</TABLE>
+
+<!-- main table -->
+<TABLE CELLSPACING=0 CELLPADDING=0 BORDER=0 height=100%>
+ <TR>
+ <TD WIDTH=16><IMG SRC="http://www.nevrax.org/inc/img/pixel.gif" WIDTH="16" HEIGHT="10" BORDER=0 ALT=""></TD>
+ <TD WIDTH=140 BGCOLOR=#dddddd VALIGN=TOP ALIGN=middle><IMG SRC="http://www.nevrax.org/inc/img/pixel.gif" WIDTH="140" HEIGHT="10" BORDER=0 ALT="">
+
+ <!------ Begin Box ------>
+ <TABLE BORDER=0 CELLSPACING=0 CELLPADDING=0 BGCOLOR=black><TR><TD><TABLE border=0 cellspacing=2 cellpadding=0 width=120><tr><TD ALIGN=middle bgcolor=black>
+ <FONT COLOR=white FACE="sans-serif"><B>Nevrax.org</B></FONT></TD></TR><tr><td colspan=2 bgcolor=#FFFFFF>
+ <TABLE cellspacing=0 cellpadding=1 border=0>
+ <tr><td ALIGN=middle><a class='linkbox' href="http://www.nevrax.org/news/" TITLE="Rubrique news"><img width=13 height=15 hspace=5 border=0 src=http://www.nevrax.org/inc/img/picto-news.gif ALT=#></A></td><td><a class='linkbox' href="http://www.nevrax.org/news/" TITLE="News">News</a></td></tr>
+ <tr><td ALIGN=middle><a class='linkbox' href="http://www.nevrax.org/mail/" TITLE="Rubrique mail"><img width=15 height=11 hspace=5 border=0 src=http://www.nevrax.org/inc/img/picto-mail.gif ALT=#></A></td><td><a class='linkbox' href="http://www.nevrax.org/mail/" TITLE="Mailing list archive">Mailing-list</a></td></tr>
+ <tr><td ALIGN=middle><a class='linkbox' href="http://www.nevrax.org/docs/" TITLE="Rubrique docs"><img width=14 height=16 hspace=5 border=0 src=http://www.nevrax.org/inc/img/picto-docs.gif ALT=#></A></td><td><a class='linkbox' href="http://www.nevrax.org/docs/" TITLE="Documentation">Documentation</a></td></tr>
+ <tr><td ALIGN=middle><a class='linkbox' href="http://www.nevrax.org/cvs/" TITLE="Rubrique cvs"><img width=13 height=17 hspace=5 border=0 src=http://www.nevrax.org/inc/img/picto-cvs.gif ALT=#></A></td><td><a class='linkbox' href="http://www.nevrax.org/cvs/" TITLE="CVS Web">CVS</a></td></tr>
+ <tr><td ALIGN=middle><a class='linkbox' href="http://www.nevrax.org/bugs/" TITLE="Rubrique bugs"><img width=20 height=16 hspace=5 border=0 src=http://www.nevrax.org/inc/img/picto-bugs.gif ALT=#></A></td><td><a class='linkbox' href="http://www.nevrax.org/bugs/" TITLE="Bugtracking">Bugs</a></td></tr>
+ <tr><td ALIGN=middle><a class='linkbox' href="http://www.nevrax.org/GPL.php3" TITLE="Rubrique license"><img width=18 height=12 hspace=5 border=0 src=http://www.nevrax.org/inc/img/picto-gpl.gif ALT=#></A></td><td><a class='linkbox' href="http://www.nevrax.org/GPL.php3" TITLE="License">License</a></td></tr>
+ </TABLE>
+ </TD></TR></TABLE></TD></TR></TABLE>
+ <!------ End Box ------>
+
+ </TD>
+ <TD WIDTH=15><IMG SRC="http://www.nevrax.org/inc/img/pixel.gif" WIDTH="16" HEIGHT="16" BORDER=0 ALT=""></TD>
+ <TD ALIGN=left valign=top><IMG SRC="http://www.nevrax.org/inc/img/pixel.gif" WIDTH="140" HEIGHT="10" BORDER=0 ALT="">
+
+<!-- title -->
+<TABLE background="http://www.nevrax.org/inc/img/redline.gif" CELLSPACING=0 CELLPADDING=0 BORDER=0 width=100%><tr><td>
+<A HREF="http://www.nevrax.org/docs/"><img src="http://www.nevrax.org/inc/img/t_docs.gif" ALT="Docs" HEIGHT=20 BORDER=0></A>
+</td><td><IMG SRC="http://www.nevrax.org/inc/img/pixel.gif" WIDTH="1" HEIGHT="1" BORDER=0 ALT="">
+</td></tr></table>
+&nbsp;
+
+<!-- block -->
+<TABLE bgcolor="#dddddd" CELLSPACING=0 CELLPADDING=0 BORDER=0 width=100%><tr><td width=1% valign=middle><img width=6 height=14 hspace=2 vspace=2 src="http://www.nevrax.org/inc/img/reddots.gif"></TD>
+ <TD><B>Documentation</B></TD>
+ <TD ALIGN=RIGHT>&nbsp;</td>
+</tr></table>
+<!-- Generated by Doxygen 1.2.14 -->
+<center>
+<a class="qindex" href="index.html">Main Page</a> &nbsp; <a class="qindex" href="namespaces.html">Namespace List</a> &nbsp; <a class="qindex" href="hierarchy.html">Class Hierarchy</a> &nbsp; <a class="qindex" href="classes.html">Alphabetical List</a> &nbsp; <a class="qindex" href="annotated.html">Compound List</a> &nbsp; <a class="qindex" href="files.html">File List</a> &nbsp; <a class="qindex" href="namespacemembers.html">Namespace Members</a> &nbsp; <a class="qindex" href="functions.html">Compound Members</a> &nbsp; <a class="qindex" href="globals.html">File Members</a> &nbsp; <a class="qindex" href="pages.html">Related Pages</a> &nbsp; <a class="qindexRef" doxygen="_cgi:http://www.nevrax.org/cgi-bin/nel-search.cgi" href="http://www.nevrax.org/cgi-bin/nel-search.cgi">Search</a> &nbsp; </center>
+<hr><h1>sound_driver.cpp</h1><a href="sound__driver_8cpp.html">Go to the documentation of this file.</a><div class="fragment"><pre>00001
+00007 <font class="comment">/* Copyright, 2001 Nevrax Ltd.</font>
+00008 <font class="comment"> *</font>
+00009 <font class="comment"> * This file is part of NEVRAX NEL.</font>
+00010 <font class="comment"> * NEVRAX NEL is free software; you can redistribute it and/or modify</font>
+00011 <font class="comment"> * it under the terms of the GNU General Public License as published by</font>
+00012 <font class="comment"> * the Free Software Foundation; either version 2, or (at your option)</font>
+00013 <font class="comment"> * any later version.</font>
+00014 <font class="comment"></font>
+00015 <font class="comment"> * NEVRAX NEL is distributed in the hope that it will be useful, but</font>
+00016 <font class="comment"> * WITHOUT ANY WARRANTY; without even the implied warranty of</font>
+00017 <font class="comment"> * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU</font>
+00018 <font class="comment"> * General Public License for more details.</font>
+00019 <font class="comment"></font>
+00020 <font class="comment"> * You should have received a copy of the GNU General Public License</font>
+00021 <font class="comment"> * along with NEVRAX NEL; see the file COPYING. If not, write to the</font>
+00022 <font class="comment"> * Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,</font>
+00023 <font class="comment"> * MA 02111-1307, USA.</font>
+00024 <font class="comment"> */</font>
+00025
+00026 <font class="preprocessor">#include "<a class="code" href="sound__driver_8h.html">sound/driver/sound_driver.h</a>"</font>
+00027 <font class="preprocessor">#include "<a class="code" href="debug_8h.html">nel/misc/debug.h</a>"</font>
+00028
+00029
+00030 <font class="preprocessor">#ifdef NL_OS_WINDOWS</font>
+00031 <font class="preprocessor"></font>
+00032 <font class="preprocessor">#include &lt;windows.h&gt;</font>
+00033
+00034 <font class="preprocessor">#else // NL_OS_WINDOWS</font>
+00035 <font class="preprocessor"></font>
+00036 <font class="preprocessor">#include &lt;dlfcn.h&gt;</font>
+00037
+00038 <font class="preprocessor">#endif // NL_OS_WINDOWS</font>
+00039 <font class="preprocessor"></font>
+00040
+00041 <font class="keyword">namespace </font>NLSOUND
+00042 {
+00043
+00044
+00045 <font class="comment">// Interface version</font>
+<a name="l00046"></a><a class="code" href="classNLSOUND_1_1ISoundDriver.html#p0">00046</a> <font class="keyword">const</font> uint32 ISoundDriver::InterfaceVersion = 0x04;
+00047
+00048 <font class="keyword">typedef</font> ISoundDriver* (*ISDRV_CREATE_PROC)(void);
+00049 <font class="keyword">const</font> <font class="keywordtype">char</font> *<a class="code" href="namespaceNLSOUND.html#a39">IDRV_CREATE_PROC_NAME</a> = <font class="stringliteral">"NLSOUND_createISoundDriverInstance"</font>;
+00050
+00051 <font class="keyword">typedef</font> <a class="code" href="memory__common_8h.html#a11">uint32</a> (*<a class="code" href="namespaceNLSOUND.html#a40">ISDRV_VERSION_PROC</a>)(void);
+00052 <font class="keyword">const</font> <font class="keywordtype">char</font> *<a class="code" href="namespaceNLSOUND.html#a41">IDRV_VERSION_PROC_NAME</a> = <font class="stringliteral">"NLSOUND_interfaceVersion"</font>;
+00053
+00054
+00055
+00056 <font class="comment">/*</font>
+00057 <font class="comment"> * The static method which builds the sound driver instance</font>
+00058 <font class="comment"> */</font>
+<a name="l00059"></a><a class="code" href="classNLSOUND_1_1ISoundDriver.html#d0">00059</a> ISoundDriver *ISoundDriver::createDriver()
+00060 {
+00061 <a class="code" href="namespaceNLSOUND.html#a38">ISDRV_CREATE_PROC</a> createSoundDriver = NULL;
+00062 <a class="code" href="namespaceNLSOUND.html#a40">ISDRV_VERSION_PROC</a> versionDriver = NULL;
+00063
+00064 <font class="preprocessor">#ifdef NL_OS_WINDOWS</font>
+00065 <font class="preprocessor"></font>
+00066 <font class="comment">// WINDOWS code.</font>
+00067 HINSTANCE hInst;
+00068
+00069 hInst = LoadLibrary(NLSOUND_DLL_NAME);
+00070
+00071 <font class="keywordflow">if</font> (!hInst)
+00072 {
+00073 <font class="keywordflow">throw</font> ESoundDriverNotFound();
+00074 }
+00075
+00076 <font class="keywordtype">char</font> buffer[1024], *ptr;
+00077 SearchPath (NULL, NLSOUND_DLL_NAME, NULL, 1023, buffer, &amp;ptr);
+00078 <a class="code" href="debug_8h.html#a1">nlinfo</a> (<font class="stringliteral">"Using the library '"</font>NLSOUND_DLL_NAME<font class="stringliteral">"' that is in the directory: '%s'"</font>, buffer);
+00079
+00080 createSoundDriver = (ISDRV_CREATE_PROC) GetProcAddress (hInst, <a class="code" href="namespaceNLSOUND.html#a39">IDRV_CREATE_PROC_NAME</a>);
+00081 <font class="keywordflow">if</font> (createSoundDriver == NULL)
+00082 {
+00083 <a class="code" href="debug_8h.html#a1">nlinfo</a>( <font class="stringliteral">"Error: %u"</font>, GetLastError() );
+00084 <font class="keywordflow">throw</font> ESoundDriverCorrupted();
+00085 }
+00086
+00087 versionDriver = (ISDRV_VERSION_PROC) GetProcAddress (hInst, <a class="code" href="namespaceNLSOUND.html#a41">IDRV_VERSION_PROC_NAME</a>);
+00088 <font class="keywordflow">if</font> (versionDriver != NULL)
+00089 {
+00090 <font class="keywordflow">if</font> (versionDriver()&lt;ISoundDriver::InterfaceVersion)
+00091 <font class="keywordflow">throw</font> ESoundDriverOldVersion();
+00092 <font class="keywordflow">else</font> <font class="keywordflow">if</font> (versionDriver()&gt;ISoundDriver::InterfaceVersion)
+00093 <font class="keywordflow">throw</font> ESoundDriverUnknownVersion();
+00094 }
+00095
+00096 <font class="preprocessor">#elif defined (NL_OS_UNIX)</font>
+00097 <font class="preprocessor"></font>
+00098 <font class="comment">// Unix code</font>
+00099 <font class="keywordtype">void</font> *handle = dlopen(NLSOUND_DLL_NAME, RTLD_NOW);
+00100
+00101 <font class="keywordflow">if</font> (handle == NULL)
+00102 {
+00103 <a class="code" href="debug_8h.html#a2">nlwarning</a> (<font class="stringliteral">"when loading dynamic library '%s': %s"</font>, NLSOUND_DLL_NAME, dlerror());
+00104 <font class="keywordflow">throw</font> ESoundDriverNotFound();
+00105 }
+00106
+00107 <font class="comment">/* Not ANSI. Might produce a warning */</font>
+00108 createSoundDriver = (ISDRV_CREATE_PROC) dlsym (handle, <a class="code" href="namespaceNLSOUND.html#a39">IDRV_CREATE_PROC_NAME</a>);
+00109 <font class="keywordflow">if</font> (createSoundDriver == NULL)
+00110 {
+00111 <a class="code" href="debug_8h.html#a2">nlwarning</a> (<font class="stringliteral">"when getting function in dynamic library '%s': %s"</font>, NLSOUND_DLL_NAME, dlerror());
+00112 <font class="keywordflow">throw</font> ESoundDriverCorrupted();
+00113 }
+00114
+00115 versionDriver = (ISDRV_VERSION_PROC) dlsym (handle, <a class="code" href="namespaceNLSOUND.html#a41">IDRV_VERSION_PROC_NAME</a>);
+00116 <font class="keywordflow">if</font> (versionDriver != NULL)
+00117 {
+00118 <font class="keywordflow">if</font> (versionDriver()&lt;ISoundDriver::InterfaceVersion)
+00119 <font class="keywordflow">throw</font> ESoundDriverOldVersion();
+00120 <font class="keywordflow">else</font> <font class="keywordflow">if</font> (versionDriver()&gt;ISoundDriver::InterfaceVersion)
+00121 <font class="keywordflow">throw</font> ESoundDriverUnknownVersion();
+00122 }
+00123
+00124 <font class="preprocessor">#else // NL_OS_LINUX</font>
+00125 <font class="preprocessor"></font><font class="preprocessor">#error "Dynamic DLL loading not implemented!"</font>
+00126 <font class="preprocessor"></font><font class="preprocessor">#endif // NL_OS_LINUX</font>
+00127 <font class="preprocessor"></font>
+00128 <a class="code" href="classNLSOUND_1_1ISoundDriver.html#b0">ISoundDriver</a> *ret = createSoundDriver();
+00129 <font class="keywordflow">if</font> ( ret == NULL )
+00130 {
+00131 <font class="keywordflow">throw</font> ESoundDriverCantCreateDriver();
+00132 }
+00133 <font class="keywordflow">return</font> ret;
+00134 }
+00135
+00136
+00137 } <font class="comment">// NLSOUND</font>
+</pre></div>
+
+<!-- footer -->
+<BR><FONT Size=+5>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </FONT>
+</TD>
+<TD WIDTH=15><IMG SRC=http://www.nevrax.org/inc/img/pixel.gif WIDTH=15 HEIGHT=15 BORDER=0 ALT=""></TD>
+</TR>
+</TABLE>
+</BODY>
+</HTML>