3D RSX  Contents  Interfaces  Data Structures  Previous  Next

Troubleshooting 3D RSX

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

 


Using the Debug Version of 3D RSX

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

To run the debug version of 3D RSX replace the release (non-debug) version of 3D RSX 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 3D RSX 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 3D RSX 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 3D RSX 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 3D RSX with the debug level set to 2 or greater. This will help you with errors in writing 3D RSX 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 3D RSX, or this specified buffer format is not supported by the 3D RSX 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.

3D RSX  Contents  Interfaces  Data Structures  Previous  Next

Copyright ©1996, 1997 Intel Corporation. All rights reserved