home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
DOS/V Power Report 1997 January
/
VPR9701B.ISO
/
k
/
other
/
winnt_e
/
readme.nt
< prev
next >
Wrap
Text File
|
1996-04-10
|
28KB
|
589 lines
README.NT MATROX GRAPHICS INC. April 10, 1996
Matrox MGA
Drivers for Windows NT 3.51
on x86 CPUs
Rev. 2.13.032 (3.5.32)
History
~~~~~~~
Rev. 2.13 (3.5.32) Miniport: 200MHz strapping fix.
User-mode: GDIINFO H/VSize fix.
Rev. 2.13 (3.5.31) Miniport: code clean-up.
User-mode: fix for video parameters in DrvAssertMode.
Rev. 2.20 (3.5.30) Miniport: code clean-up.
User-mode: fix for video parameters in DrvAssertMode.
Rev. 2.20 (3.5.29) Based on Rev. 2.13.028.
Miniport: modifications for selecting resolutions
according to MGA.INF file or refresh rates.
User-mode: modifications to act on MgaInfoFile and
CenterDialogs Registry values.
Rev. 2.13 (3.5.28) Miniport: modifications for selecting resolutions
according to MGA.INF file or refresh rates.
User-mode: modifications to act on MgaInfoFile and
CenterDialogs Registry values.
Rev. 2.20 (3.5.27) Based on Rev. 2.13.026.
Miniport: supports MS-developed user-mode driver.
User-mode: recompiled MS-developed driver, with
addition of CHECK_VSYNC for TVP3026.
Rev. 2.13 (3.5.26) Miniport: new FindAdapter function.
User-mode: check for vsync present in pointer code.
Rev. 2.12 (3.5.25) Miniport: fix for VL Bios mapping.
Rev. 2.12 (3.5.24) Miniport: fix for invalid size in FreeMemory.
Rev. 2.12 (3.5.23) Miniport: fix for invalid access ranges.
Rev. 2.12 (3.5.22) Miniport: fix for compiler bug in DDC code.
Rev. 2.12 (3.5.21) Miniport: compatible with NT 3.51;
supports DDC for Compaq computers.
User-mode: supports 15bpp modes, although none is
currently returned by the miniport driver.
Rev. 2.11 (3.5.20) Miniport: not compatible with NT 3.51 (same as
Rev. 2.10.018, except for TVP3026 fixes).
User-mode: same as Rev. 2.10.018. Released.
Rev. 2.11 (3.5.19) Tested on Windows NT 3.51 Build 969.
Numerous small changes to the miniport driver in
order to straighten things out.
The user-mode driver should now be able to support
15bpp modes, although none is currently returned
by the miniport driver.
Rev. 2.10 (3.5.18) Internal build for GetPixel fix.
Rev. 2.10 (3.5.17) New DDC parameters.
Rev. 2.10 (3.5.16) Internal build with 3D modes.
Rev. 2.10 (3.5.15) Added DDC support in miniport driver. Released.
Rev. 2.10 (3.5.14) Change to TVP3026 clock programming in miniport driver;
Change to TVP3026 programming for hardware cursors in
user-mode driver.
Rev. 2.10 (3.5.13) Change to TVP3026 clock programming in miniport driver;
MGAMON.EXE replaced by MGASET.CPL and MONDLG.DLL.
Rev. 2.10 (3.5.12) A few fixes in user-mode driver.
Rev. 2.10 (3.5.11) New low-level code in miniport driver.
Unified multi-board user-mode driver.
Rev. 2.10 (3.5.10) Multi-board drivers.
Rev. 2.01 (3.5.2) Fix for AutoFormat problem in Excel 5.0.
Rev. 2.01 (3.5.1) New low-level code in miniport driver (support of
(MGA-III rev. 2, support of 8-bit block mode, sync
polarity for Viewpoint);
Updating registry with board information;
Small fonts/large fonts work correctly.
Version numbers are consistent.
New programming of TVP3026 ramdac.
Rev. 2.01 RC1 Rev. 2.01 is the current up-to-date version;
Rev. 2.00 is the rev distributed on the Windows NT 3.5
CD-ROM, and is an earlier version.
Rev. 2.00 RC1a Appropriate resolution selection for MGA-I boards;
Fixes for Impression-PRO.
Rev. 2.00 RC1 New low-level functions in miniport driver;
Very few changes to user-mode drivers.
Rev. 2.00 Numerous modifications for Windows NT 3.5 Beta
and for new board configurations.
Rev. 1.13 Modifications for ATT ramdac and for clock
frequencies (MGA.SYS).
Rev. 1.12 New code for Athena chip (MGA.SYS);
Addition of TXTSETUP.OEM file.
Rev. 1.11 Implementation of alternate PCI mechanism (MGA.SYS).
Rev. 1.10 Upgrade from Rev. 1.00.
Rev. 1.00 Initial version.
Windows NT Files on this Disk
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
\MGA_VID Tag file for Windows NT Setup
\MGA.SYS MGA miniport driver
\MGA.DLL MGA user-mode driver
\OEMSETUP.INF MGA driver installation file for Windows NT
\TXTSETUP.OEM MGA driver installation file for Windows NT
\MGA.MON MGA monitor file
\MGASET.CPL Monitor selection applet for Control Panel
\MONDLG.DLL DLL required by the Monitor selection applet
\MGAVGA.EXE Utility used to initialize the MGA to VGA mode
\README.NT This file
About These Drivers
~~~~~~~~~~~~~~~~~~~
These drivers support all Matrox MGA Ultima, Ultima-Plus, Impression,
Impression-Plus, Impression-Pro, and Impression-Lite boards.
These drivers are not the same as the ones supplied on the installation
disks of Windows NT 3.51. Here are the main differences:
These drivers Drivers supplied by Microsoft
----------------------------- -----------------------------
Hardware-accelerated 3D Hardware-accelerated 3D
is not implemented is implemented for 32k-
colors modes
----------------------------- -----------------------------
16 bits-per-pixel modes 16 bits-per-pixel modes
support 64k colors support 32k colors
----------------------------- -----------------------------
Dual-board configurations Dual-board configurations
are available are not available
----------------------------- -----------------------------
Display refresh rates are Display refresh rates are
set through the MGA Monitor set through the Display
applet or through the Display applet
applet
----------------------------- -----------------------------
DDC is supported for Compaq DDC is not supported
computers
----------------------------- -----------------------------
Switching from one set of drivers to the other is possible. However, the
different way of setting refresh rates may cause a warning about an invalid
resolution being requested. This warning could appear when the system is
rebooted after switching drivers, and it should go away if the mode to be
used is reset through the Display applet.
Installation
~~~~~~~~~~~~
Refer to your MGA Owner's Manual to install your MGA board(s) in your
system.
If you are installing two MGA boards in your system, please note that
only one should be VGA-enabled through the on-board switch. Dual-
board installations are similar to a single board installation. The
system will automatically assign separate addresses to each PCI board
allowing the driver to distinguish between the two boards. In a dual-
board configuration, both boards must run with the same resolution and
pixel-depth. It is recommended that no ISA board be mapped at 0xAC000
in a multi-board setup.
If both PCI and VLB/ISA MGA boards are installed in your system, you can
achieve better performance by following a few simple rules:
- The VGA-enabled board should be, in order of preference:
1. the more capable PCI board;
2. any PCI board;
3. the more capable VLB board;
4. any VLB board;
5. the more capable ISA board;
6. any ISA board.
- Among VLB and ISA boards, set the mappings of the VLB boards so that
they are lower than the mappings of the ISA boards. The available
mappings are, in ascending order: 0xAC000, 0xC8000, 0xCC000,
0xD0000, 0xD4000, 0xD8000, and 0xDC000.
- Among VLB boards, set the mappings of the more capable boards so that
they are lower than the mappings of less capable boards. Proceed
similarly among ISA boards.
These rules will allow the driver to use the high-performance PCI and VLB
boards instead of the slower ISA boards whenever possible. In general,
the 'more capable' boards are those that hold more memory. However, you
may decide that some other capability, such as 3D acceleration or true color
output, is more important to your work, and you may set a different order
among the VLB or ISA boards.
The general procedure for changing a display driver is the following:
- Open the ControlPanel/Display applet.
- Press the 'Change Display Type...' button.
- In the Display Type dialog box, press the 'Change...' button.
- In the Select Device dialog box, press the 'Other...' button.
- In the Install From Disk dialog box, type the location of the
Matrox MGA installation files (e.g. "A:\WINNT").
- From the displayed list, select a resolution and pixel depth
supported by your board and monitor, then press 'Install'.
Refer to your MGA Owner's Manual or run the SETUP program (see Board
Testing below) to determine the supported resolution and pixel depth
combinations.
- Answer 'Yes' to the Installing Driver dialog box.
- If the MGA drivers are already installed on your system, you
will be prompted to choose between the currently installed
drivers or new ones. If you select 'New', you will be prompted
for the path to the new driver files. This will default to the
path entered in the Install From Disk dialog box.
- In the Display Settings Change dialog box, you should select
'Restart Now' so that the new settings take effect.
- If your system does not reboot at the expected resolution, it is
probable that your board does not support the selected resolution/
pixel depth combination. Open ControlPanel/Display again and press
the 'List All Modes...' button to get all the modes available for
your particular board. You can also experiment with the 'Color
Palette' and 'Desktop Area' controls to select a new mode. Use
the 'Test' button to make sure that the new mode is supported by
your monitor.
Please note that Rev. 2.1x or higher of the MGA drivers for Windows NT
require a new OEMSETUP.INF file. Using a previous version of OEMSETUP.INF
will not work, or might lead to an incorrect installation. This is because
earlier versions installed a separate driver for 256, 64K, and 16M colors
operation, while the current version installs a single user-mode driver.
With older BIOSes, running a full-screen Command Prompt application in a
single-screen system requires that MGAVGA.EXE be executed at the start of
the DOS session. MGAVGA.EXE has been copied into the SystemRoot\SYSTEM32
subdirectory at installation time, where SystemRoot stands for your Windows
NT installation path (SystemRoot is an environment variable: its value will
be in the list displayed when the command 'set' is typed in a Command Prompt
session). To make sure that MGAVGA is run automatically at the start of each
Command Prompt session, you can include the following line in your
AUTOEXEC.NT file:
%SystemRoot%\system32\mgavga
Removing Older Versions
~~~~~~~~~~~~~~~~~~~~~~~
If a version of the MGA drivers older than Rev. 2.10 were installed on your
system, you can delete the outdated drivers after the current version has
been installed. You can proceed as follows:
- Start a Command Prompt session.
- Change to the SystemRoot\SYSTEM32 subdirectory.
- Type: del mga8.dll
del mga16.dll
del mga24.dll
This will free approximately 200 kbytes. Moreover, the monitor selection
utility has been replaced by a Control Panel applet, so you can remove the
outdated MGAMON.EXE file:
- Type: del mgamon.exe
This will free approximately 120 kbytes. You may also wish to remove
outdated entries from the Registry. This can be achieved by running
REGEDT32.EXE (located in the SystemRoot\SYSTEM32 subdirectory):
- Start REGEDT32.
- Select the HKEY_LOCAL_MACHINE window, and highlight the tree root.
- Select View/Find Key...
- In the Find dialog box, enter 'mga' as the string to be found, and
unselect 'Match Whole Word Only'. Make sure that 'Match Case' is
not selected, and that the search direction is Down.
- Find all instances of the string by repeatedly pressing the 'Find
Next' button. You can safely delete (by pressing the Del key on
your keyboard) all instances of 'mga8', 'mga16', and 'mga24'.
DO NOT DELETE any 'mga' key! The 'mga*' keys will probably be found
in
SYSTEM\ControlSetNNN\Services\EventLog\System
and
SYSTEM\ControlSetNNN\Services.
Changing Resolution
~~~~~~~~~~~~~~~~~~~
Whenever you want to change resolution, run the ControlPanel/Display applet.
The available modes are displayed through the 'List All Modes...' button.
If you are using a dual-screen configuration, the driver will spread the
desktop over the two monitors. Special dual-screen resolutions will be
listed where the horizontal or vertical resolutions are twice their
normal size. Selecting one of these resolutions will permit testing of
both monitors.
Monitor Customization
~~~~~~~~~~~~~~~~~~~~~
There are two ways to select refresh rates for your monitor. Whenever
a new driver is installed, it is assumed that refresh rates are selected
through the ControlPanel/MGA Monitor applet. If your preference goes to
selecting refresh rates through the 'Refresh Frequency' field of the
ControlPanel/Display applet, you will have to edit a value in the Registry.
Both options are described below. The section 'Editing the Registry' gives
details on how to modify the values that control driver behavior.
After installation, the display driver assumes that refresh rates will be set
through the MGA Monitor applet. However, since the applet has not been run
yet, the driver will assume that your monitor is capable of handling all
resolutions from 640x480 up to 1600x1200 at a 60 Hz refresh rate. If your
monitor does not support the higher resolutions, or if it is capable of
higher refresh rates, you can run the ControlPanel/MGA Monitor applet and
select a suitable monitor from the list. This will ensure that your monitor
will not be over-driven, and that you will get the benefits of higher refresh
rates.
The MGA Monitor applet should have been copied by the Windows NT Setup
program into your SystemRoot\SYSTEM32 subdirectory when the MGA drivers
were installed. To customize your monitor:
- Open the ControlPanel/MGA Monitor applet.
- From the list of monitors, select the appropriate monitor, or one
whose maximum refresh rate matches the one you are using. An
MGA.INF file will be created in the SystemRoot\SYSTEM32
subdirectory.
To make sure that the newly created MGA.INF is correct for your monitor:
- From Control Panel, start the Display applet.
- Select the resolution and pixel depth you wish to test.
- Press the 'Test' button. The test will use the video parameters
appropriate for the monitor selected in MGA Monitor.
If your monitor does not display a stable test screen, then the parameters
set by MGA.INF are not suitable for your monitor. Press the 'Cancel' button
to close Display, run MGA Monitor again to select another monitor from the
list, and repeat the Display test.
If the test screen is not displayed, but you get instead a message box about
the screen not being visible due to a limitation of your video card or
display monitor, then it is probable that the tested resolution (say,
1280 x 1024) was above the limit set by MGA.INF (say, 1024 x 768). If your
monitor is capable of the higher resolution, then run MGA Monitor again to
select an appropriate monitor.
The new MGA.INF will take effect when you restart Windows NT. Any resolution
higher than the set limit will not appear in the Display applet mode list.
Deleting MGA.INF will remove all monitor limits to the resolution, although
the refresh rate will default to 60Hz.
In a dual-board configuration, both boards will output the same refresh
rate to each monitor. It is recommended that the monitor selected in MGA
Monitor be compatible with the less capable monitor in your setup.
If you would rather select refresh rates through the ControlPanel/Display
applet, set the 'User.MgaInfoFile' value in the Registry to 0 (see the
'Editing the Registry' section for details). The next time you reboot,
refresh rates available for each mode will be returned to the Display
applet. The system will probably reboot in the 640x480x8 mode, and a
warning message will be displayed. This is normal, since the system could
not find the hardware default setting that was used previously for refresh
rates. You can now select refresh rates from the list displayed by
ControlPanel/Display. You should test any new mode to make sure that your
monitor actually supports the new resolution/refresh rate combination.
In a dual-board configuration, both boards will output the same refresh
rate to each monitor. The less capable monitor in your setup will determine
the maximum refresh rate.
Editing the Registry
~~~~~~~~~~~~~~~~~~~~
Information held in the Windows NT Registry can have a direct effect on the
whole system. Introducing incorrect values can cause serious problems and
may make it necessary to reinstall Windows NT. The changes outlined below
should have effects limited to the MGA drivers. However, if you accidentally
modify values that make your system unusable, please note that it is often
possible to undo the damage by using the 'Last Known Good Configuration'
option at boot time.
Modifying keys and values in the Registry is done through the Registry
Editor. The Registry Editor can be invoked in the following way:
- Open a Command Prompt window.
- Type 'regedt32'. The Registry Editor will come up.
To modify the values that govern the behavior of the MGA driver:
- Select the HKEY_LOCAL_MACHINE window.
- Travel down to the key named:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\mga\Device0.
In the right window pane, you will find many values. Two values control the
general behavior of the driver:
User.CenterDialogs when set to 1, allows centering of dialog boxes and
pop-up windows on the top left display of a dual-screen
setup. The centered windows can still be moved over the
whole desktop. A value of 0 will have no effect on the
position of these windows.
There are serious side-effects to this feature. For
instance, testing a dual-screen mode from the
ControlPanel/Display applet will actually test only the
corresponding single-screen mode. Other side-effects
include toolbars that will not use the whole desktop, and
screen savers that will work only on the top left screen.
The default value of User.CenterDialogs is 0.
User.MgaInfoFile when set to 1, allows use of the MGA Monitor applet
to control refresh rates. A value of 0 will allow the
Display applet to list available refresh rates. See
the 'Monitor Customization' section for more details.
The default value of User.MgaInfoFile is 1.
If you wish to change any of these values:
- Double-click on the selected value.
- In the DWORD Editor, change the value to '0' or '1'. The new value
will take effect the next time you reboot.
Board Testing
~~~~~~~~~~~~~
If you encounter any problem running Windows NT with your board, you should
first determine whether it is a system or hardware problem. The best way
to check for a potential hardware problem is to use the MGA Setup program.
SETUP is a DOS program included on Disk #1 of the Power Driver package.
It cannot be run from a Windows NT Command Prompt session.
If you have a DOS (FAT) partition on your hard disk, simply install the
Setup and Utilities product using the provided Installation program. Then
go to the \MGA\SETUP program and type SETUP.
If you do not have a DOS partition, you will have to create a bootable
disk with SETUP on it. Here is the procedure:
- Insert Power Driver disk#1 in your diskette drive
- copy a:\setup\files1.zip and a:\pkunzip.exe to your hard disk
- type "pkunzip files1" to unzip the files
- format a DOS bootable disk
- copy the following files to your new floppy disk:
SETUP.EXE, DOS4GW.EXE, MGA.MON
- Reboot your computer with the the new diskette
- type "setup"
In SETUP, select "Graphic Mode Test" to test the different modes available
for your board. The program will not attempt to test a mode which is not
supported by your board. The default testing will be done at a 60Hz refresh
rate for all resolutions.
If you have a customized monitor file (MGA.INF) in your SystemRoot\SYSTEM32
subdirectory, SETUP can take it into account, if you set the MGA environment
variable as follows:
set mga=SystemRoot\system32
where SystemRoot stands for your Windows NT installation path.
Known Bugs and Limitations
~~~~~~~~~~~~~~~~~~~~~~~~~~
- Running a full-screen Command Prompt application in a single-screen
system might not work quite as expected. If you encounter problems,
try running MGAVGA.EXE at the start of the DOS session. You can
include this program in the SystemRoot\SYSTEM32\AUTOEXEC.NT batch
file, so that it is run automatically at the start of each Command
Prompt session.
- We are aware of conflicts between the MGA boards and some SCSI
adapters. The cause of these conflicts has not been determined yet.
In our experience, there are some conbinations of addresses that do
work.
- If your board is a MGA-I VL-bus board you might get the following
error message soon after log-in:
Dr. Watson for Windows NT
An application error has occurred
and an application error log is being generated.
ntvdm.exe
This error will prevent you from running most DOS applications in a
Command Prompt window and all Windows 3.1 applications. However,
there are ways to eliminate or work around the problem.
You should check first whether your computer can shadow the video
BIOS. If it can, there will be an entry for this capability in the
BIOS setup program, which can be run at boot time on some machines,
or at any time on some other, by depressing a combination of keys.
If this capability exists, you should enable it and then boot
Windows NT to check whether this solves the NTVDM problem. We are
aware that this procedure does not work on all computers. If BIOS
shadowing is impossible or if it does not fix the NTVDM error,
then there are two work-arounds.
To run DOS applications, you will have to create a special Command
Prompt icon. To do this, go into your 'Main' window, then click on
'File' and 'New'. Select 'Program Item' in the dialog box and
click on OK. In the Program Item Properties dialog box, type in
a 'Description:' (say, "Special Command Prompt"), and type in the
'Command Line:' "CMD.EXE /KSystemRoot\system32\mem.exe", where
you should substitute "SystemRoot" with the appropriate path to
your Windows NT directory. Press the Change Icon button to select an
appropriate icon, and then press OK until the new program icon is
displayed in your 'Main' window. Double-click on your Special
Command Prompt icon; you will get the ntvdm error message, but
just go on. Click on the Close button, then select 'Settings...'.
In the dialog box, set 'Full Screen' and 'Save Configuration', and
then press OK. Type 'exit' to close the Command Prompt session.
From now on, a Special Command Prompt session will always start as a
full-screen session and will execute MEM.EXE automatically. You
should then be able to run a DOS application either from the full
screen prompt or, by pressing Alt-Enter, from a windowed session.
To run Windows 3.1 applications, you will first have to find out
the path to any of your Windows 3.1 applications. To do this, click
on its icon and press Alt-Enter; the 'Command Line:' box holds this
information. Close the dialog box and start a Command Prompt session
(NOT a Special Command Prompt session), then switch to full screen
by pressing Alt-Enter, change to the appropriate subdirectory and
start your application from the command line, typing in the name of
its .EXE file. Your screen should revert to graphics mode and your
application should start. From now on, and until you exit your
current Windows NT session, you can start any Windows 3.1 application
by double-clicking on its icon.
You may encounter a similar error with MGA-I VLB-bus boards,
which will read:
Hidden Console of WOW VDM
NTVDM has encountered a system error
the handle is invalid.
Choose 'close' to terminate the application.
In this case, there is only one workaround. You must map the board
to DC00. If you are running dual screen with another MGA-I VLB-bus
or AT-bus board you can set either board to DC00. If you can't do
that because of a conflict with another device, you must revert to
the "software" work-arounds outlined above.
- If your board is a MGA-I AT-bus board mapped at 0xAC000 you might
get the same problem as listed above with the VL-bus board. Again the
easiest workaround is to shadow the video BIOS through your system
configuration. If your system does not support shadowing, it is
possible to avoid the problem by either booting your board in 16-bit
bus access mode (switch #5), or by changing your base address. If you
can't do that because of a conflict with another device, you must
revert to the "software" work-arounds outlined above.