Documentation of the AdvanceCAB svgawin utility.

1 Synopsis

svgawin [/l] [/u]

2 Description

The `svgawin` utility installs and uninstalls the svgawin.sys driver in Windows 2000/XP.

AdvanceMAME and AdvanceMENU also work without this driver, but you lose the ability to set arbitrary video modes.

If you install it, AdvanceMAME and AdvanceMENU automatically try to use it before any other driver, unless you explicitly set a different driver with the `device_video` option in the configuration files.

You must run this installation utility as Administrator.

3 Options

These are the command line options supported:

/l
Install and start the driver.
/u
Stop and uninstall the driver.

4 Troubleshooting

The svgawin drivers are inherently unsafe because they must coexist with the normal Windows drivers.

The most common problem is that the Windows driver leaves the video card in a state that the SVGAWIN driver cannot understand or restore.

The only practical solution is to reduce the video hardware acceleration to the minimum in Display Properties -> Settings -> Advanced -> Troubleshooting.

If you want a completely stable solution you must use the Linux or DOS version of AdvanceMAME and AdvanceMENU.

Alternatively you can try using two different video boards, one for Windows and the other for game display. Check the `device_svgawin_skipboard` option to control which video board to use.

5 Tech

This driver is used to export at user level some reverse-engineered operations that are generally available only at kernel level. Specifically you can:

It does not contain any video-board-specific code. It only exports these basic services.

The services interface is detailed in the advance/svgalib/svgawin/driver/svgacode.h file.