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

GA_disableVBEMode, GA_addMode, GA_delMode

Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com