RSX 3D  Contents  Interfaces  Data Structures  Previous  Next

Troubleshooting RSX 3D

The following topics describe how to run the debug version of RSX 3D and provide a brief explanation of the error codes used by RSX 3D.

 


Using the Debug Version of RSX 3D

The advantage of running the debug version of RSX 3D with your application is that when you run your application through a debugger, debug output from RSX 3D appears in the debug output window. The RSX 3D debug binary can also write a debug log file to your disk.

To run the debug version of RSX 3D replace the release (non-debug) version of RSX 3D with the debug version. You can do this in 1 of 2 ways:

  1. Copy rsx.dll from \RSX3D\bin\debug to your 'Windows System' directory. To switch back to the non-debug version you can copy the rsx.dll found in \RSX3D\bin to your 'Windows System' directory.
  2. Use the tool: regsvr32.exe provided with the Win32 SDK (and some compilers) to self-register the copy of rsx.dll found in \RSX3D\bin\debug.

Once the debug version of RSX 3D is running; set the Debug Level value in the registry to a valid debug level. To modify the registry use the program regedit.exe (found in your Windows directory). The Debug Level value is found in the RSX 3D registry key: [HKEY_LOCAL_MACHINE\Software\Intel\Realistic Sound Experience\2.0]. A value of zero turns off all debug messages, a value of one will print out error messages only and values of two through five will display debug messages in ever increasing detail (level 5 is the most detail). Level 4 will write the debug output into a text file named rsxdebug.log in your TEMP directory.


Error Codes

This section provides a detailed description of the error codes used by the RSX 3D library. Generic COM error codes are all prefixed with E_. RSX-defined error codes are prefixed with RSXERR_.

NOTE: It is a good idea to develop with the debug version of RSX 3D with the debug level set to 2 or greater. This will help you with errors in writing RSX 3D applications.

 

RSXERR_ALLOCATED
The audio device is busy and could not be allocated to create a listener, or more than one listener, was already created for this environment.
RSXERR_BADFORMAT
The audio device does not support the audio format requested by RSX 3D, or this specified buffer format is not supported by the RSX 3D library.
RSXERR_CORRUPTFILE
The specified file is not a valid .WAV, or .MID file.
RSXERR_FILENOTFOUND
File not found or another error occurred opening the file for the cached emitter.
RSXERR_FILESHARINGVIOLATION
A sharing violation occurred when attempting to open the file for the cached emitter.
RSXERR_NODRIVER
No audio driver is present.
RSXERR_PARALLELVECTORS
The orientation vectors specified are parallel. Orientation vectors should be orthogonal.
RSXERR_PLAYING
A cached emitter was playing or in a paused state when the application called SetMarkPosition or SetCacheTime. These calls only work if the cached emitter is stopped.
RSXERR_ZEROVECTOR
A zero-length vector was specified for orientation.
E_FAIL
There was a generic failure, with no explanation.
E_INVALIDARG
One or more arguments are invalid. Check for NULL-pointers or values out of range.
E_NOTIMPL
This function is not implemented in this version of the RSX library.

RSX 3D  Contents  Interfaces  Data Structures  Previous  Next

Copyright ©1996, 1997 Intel Corporation. All rights reserved