NeL: NLSOUND::ISoundDriver class Reference

+You can request support for EAX. If EAX is requested and if there is enougth hardware buffer replay, then only hardware buffer are created when calling createBuffer. If the number of available hardware buffer is less than 10, then EAX is ignored. +

00062 {
+00063         ISDRV_CREATE_PROC       createSoundDriver = NULL;
+00064         ISDRV_VERSION_PROC      versionDriver = NULL;
+00065 
+00066 #ifdef NL_OS_WINDOWS
+00067 
+00068         // WINDOWS code.
+00069         HINSTANCE                       hInst;
+00070 
+00071         hInst = LoadLibrary(NLSOUND_DLL_NAME);
+00072 
+00073         if (!hInst)
+00074         {
+00075                 throw ESoundDriverNotFound();
+00076         }
+00077 
+00078         char buffer[1024], *ptr;
+00079         SearchPath (NULL, NLSOUND_DLL_NAME, NULL, 1023, buffer, &ptr);
+00080         nlinfo ("Using the library '"NLSOUND_DLL_NAME"' that is in the directory: '%s'", buffer);
+00081 
+00082         createSoundDriver = (ISDRV_CREATE_PROC) GetProcAddress (hInst, IDRV_CREATE_PROC_NAME);
+00083         if (createSoundDriver == NULL)
+00084         {
+00085                 nlinfo( "Error: %u", GetLastError() );
+00086                 throw ESoundDriverCorrupted();
+00087         }
+00088 
+00089         versionDriver = (ISDRV_VERSION_PROC) GetProcAddress (hInst, IDRV_VERSION_PROC_NAME);
+00090         if (versionDriver != NULL)
+00091         {
+00092                 if (versionDriver()<ISoundDriver::InterfaceVersion)
+00093                         throw ESoundDriverOldVersion();
+00094                 else if (versionDriver()>ISoundDriver::InterfaceVersion)
+00095                         throw ESoundDriverUnknownVersion();
+00096         }
+00097 
+00098 #elif defined (NL_OS_UNIX)
+00099 
+00100         // Unix code
+00101         void *handle = dlopen(NLSOUND_DLL_NAME, RTLD_NOW);
+00102 
+00103         if (handle == NULL)
+00104         {
+00105                 nlwarning ("when loading dynamic library '%s': %s", NLSOUND_DLL_NAME, dlerror());
+00106                 throw ESoundDriverNotFound();
+00107         }
+00108 
+00109         /* Not ANSI. Might produce a warning */
+00110         createSoundDriver = (ISDRV_CREATE_PROC) dlsym (handle, IDRV_CREATE_PROC_NAME);
+00111         if (createSoundDriver == NULL)
+00112         {
+00113                 nlwarning ("when getting function in dynamic library '%s': %s", NLSOUND_DLL_NAME, dlerror());
+00114                 throw ESoundDriverCorrupted();
+00115         }
+00116 
+00117         versionDriver = (ISDRV_VERSION_PROC) dlsym (handle, IDRV_VERSION_PROC_NAME);
+00118         if (versionDriver != NULL)
+00119         {
+00120                 if (versionDriver()<ISoundDriver::InterfaceVersion)
+00121                         throw ESoundDriverOldVersion();
+00122                 else if (versionDriver()>ISoundDriver::InterfaceVersion)
+00123                         throw ESoundDriverUnknownVersion();
+00124         }
+00125 
+00126 #else // NL_OS_UNIX
+00127 #error "Dynamic DLL loading not implemented!"
+00128 #endif // NL_OS_UNIX
+00129 
+00130         ISoundDriver *ret = createSoundDriver(useEax, stringMapper);
+00131         if ( ret == NULL )
+00132         {
+00133                 throw ESoundDriverCantCreateDriver();
+00134         }
+00135         return ret;
+00136 }
+


Public Member Functions
virtual void	commit3DChanges ()=0
	Commit all the changes made to 3D settings of listener and sources.
virtual uint	countMaxSources ()=0
	Return the maximum number of sources that can created.
virtual IBuffer *	createBuffer ()=0
	Create a sound buffer.
virtual IListener *	createListener ()=0
	Create the listener instance.
virtual ISource *	createSource ()=0
	Create a source.
virtual void	displayBench (NLMISC::CLog *log)=0
virtual void	endBench ()=0
virtual bool	readRawBuffer (IBuffer destbuffer, const std::string &name, uint8 rawData, uint dataSize, TSampleFormat format, uint32 frequency)=0
virtual bool	readWavBuffer (IBuffer destbuffer, const std::string &name, uint8 wavData, uint dataSize)=0
	Temp.
virtual void	startBench ()=0
virtual void	writeProfile (std::ostream &out)=0
	Write information about the driver to the output stream.
virtual	~ISoundDriver ()
	Destructor.
Static Public Member Functions
ISoundDriver *	createDriver (bool useEax, IStringMapperProvider *stringMapper)
Static Public Attributes
const uint32	InterfaceVersion = 0x08
	Version of the driver interface. To increment when the interface change.
Protected Member Functions
	ISoundDriver ()
	Constructor.
virtual void	removeBuffer (IBuffer *buffer)=0
	Remove a buffer (should be called by the friend destructor of the buffer class).
virtual void	removeSource (ISource *source)=0
	Remove a source (should be called by the friend destructor of the source class).

NLSOUND::ISoundDriver Class Reference

Detailed Description

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Constructor & Destructor Documentation

Member Function Documentation

Field Documentation