|
|
|
|
GA_enableVBEMode
Enable a display mode for use by VESA VBE applications.
Declaration
ibool NAPI GA_enableVBEMode(
GA_devCtx *dc,
N_int32 xRes,
N_int32 yRes,
N_int32 bits,
N_int32 saveToDisk)
Prototype In
snap/graphics.h
Parameters
dc |
Device context for driver to add mode to |
xRes |
X resolution of the mode to add |
yRes |
Y resolution of the mode to add |
bits |
Bits per pixel for the mode to add |
saveToDisk |
True if the mode profile should be saved to disk |
Return Value
True on success, or false if the mode could not be added.
Description
This function is used to enable a specific display mode for use by VESA VBE applications in a DOS box environment. Many early VESA applications do not correctly handle large mode lists returned by the VBE driver, so only a specific subset of modes are actually reported to the VBE application by the SNAP VBE emulation driver. This function is used to enable support for specific modes that the user desires on a mode by mode basis.
Unless you pass a value of true to the saveToDisk parameter, the changes will only affect the currently loaded copy of SNAP and will not affect new versions of SNAP that are loaded from disk. To make the change permanent, you need to set this parameter to true.
Note: Modes added to this list only affect the filtering mechanism for VESA VBE applications. A mode will not be available unless it is first added to the standard mode list for the SNAP driver using GA_addMode (or if the mode is a standard mode already supported).
See Also
Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com