3D RSX  Contents  Interfaces  Data Structures  Previous  Next

Registry Settings

Registry settings control how your computer runs. Your computer system and each application that you run has a set of registry keys.

Table 1 lists the 3D RSX registry values and provides a data type, range of valid values, and a description for each.

You can use one of these means to change registry keys:

• Registry Editor
• Configuration Utility
• Tray headphone icon
• Your application

You may want to dynamically change registry settings if you plan to run your application/game in full-screen mode, or if you are debugging your program.

NOTE. When your application is in full-screen mode, the only way to dynamically change registry settings is through your application, because the other options are not visible and accessible.

Table 1. 3D RSX Registry Values

Notes:

¹ To dynamically change the value of this registry key while 3D RSX is running, change the registry value, release (destroy) the current direct listener, and then create a new one.

² To change the value of this registry key, release 3D RSX and then recreate it.

³ You can change peripherals while 3D RSX is running. See Section B.1.4 for instructions.

⁴ If this value changes while 3D RSX is running, each MIDI-based cached emitter created after the registry value changes will use the newly specified MIDI device.

⁵ If this value changes while 3D RSX is running, each emitter created after the registry value changes will have the new cache time.

Using the Registry Editor to Change Registry Settings

To access the Registry Editor from Windows^† 95, click Start and then select Run from the Windows menu. The Run applet window opens. Use the options in this window to locate and run regedit. On other systems, run WINDOWS\regedit.exe.

When you invoke regedit, the Registry Edit window opens. One side of this window contains a registry list, the other contains the corresponding registry key values. Work your way down the registry list until you reach the 2.0 registry key. The registry key is as follows:

HKEY_LOCAL_MACHINE\SOFTWARE\Intel\Realistic Sound Experience\2.0.  

When you click the 2.0 registry folder, the current registry key values appear on the right pane of the Registry Edit window.

Typical system registry settings for RSX are:

(Default)		(value not set)
Buffersize		0x00000078 (120)
Debug Level		0x00000000 (0)
Device Type		"directsound"
NumWaveBuffers		0x00000003 (3)
Peripheral		0x00000001 (1)
RSXToolPath		"C\RSX2\rsxtool.exe"

NOTE. There is no restore option on this dialog.

Enter new values for the values you want to change.

Using the Configuration Utility to Change Registry Settings

To use the Configuration Utility to change some of the registry settings, either open the Intel 3D RSX folder on your Start menu and select Configuration, or locate and run Rsxconfg.exe (which the installation copies into your RSX3D\BIN directory). You can change Buffersize, cache times, MidiID, and peripherals from the Configuration Utility. See Installing and Configuring 3D RSX for specific instructions. You can also change peripherals from the Tray applet.

Using the Tray Headphone Icon to Change Registry Settings

To change peripherals when your application is running with 3D RSX, click the headphone icon that appears in the task tray in the lower-right corner of your application window. A dialog opens that allows you to switch between speakers and headphones.

Figure 1. Headphone Icon on Tray

Changing 3D RSX Settings from Your Application

While 3D RSX is running with your application, you can change registry settings for peripherals:

1. Create and open an event named RSXRegChange. This returns a handle to an auto-reset event.
2. Update the registry with the new values.
3. Signal the event. When 3D RSX receives the signal, it updates the settings. 3D RSX automatically resets the event.
4. Close the handle to the event when you finish using it.

The following code demonstrates how to change peripherals from your application:

// registry keys
#define RSX20_REG_KEY "SOFTWARE\\Intel\\Realistic Sound Experience\\2.0"
#define RSX20_PERIPHERAL_VALUE	"Peripheral"	

// Function prototypes
HRESULT ChangeRSXRegistry(DWORD);
HRESULT OnPeripheralChange(DWORD);

// global handle to an event
HANDLE g_hRSXEvent = NULL;

// The following code should be exectued on initialization
// i.e in WinMain or the constructor for a class...
//
// The name of the event: RSXRegChange must not be changed
//

// begin initialization code
g_hRSXEvent  = CreateEvent (NULL, FALSE, FALSE, "RSXRegChange");

if(g_hRSXEvent  == NULL) {
    OutputDebugString("Error creating RSX Registry event");
    // do error processing
} // endif

// end initialization code

3D RSX  Contents  Interfaces  Data Structures  Previous  Next

Copyright ©1996, 1997 Intel Corporation. All rights reserved