include valmode.inc UINT WINAPI ValidateMode(DISPLAYINFO FAR *lpValMode);
Allows display drivers to accept or reject a mode selected by the user.
Value | Meaning |
VALMODE_YES | Valid mode. |
VALMODE_NO_WRONGDRV | Driver does not work on adapter. |
VALMODE_NO_NOMEM | Not enough video memory for settings. |
VALMODE_NO_NODAC | DAC can not handle selected colors. |
VALMODE_NO_UNKNOWN | Unknown problem. |
lpValMode
Address of a DISPLAYINFO structure that specifies the mode information such as resolution and color depth selected by the user.
All mode validation must be done in a manner that does not affect the screen.
ValidateMode can be called even if the driver is not the currently running display driver. If the user specifies a resolution/color depth that requires Windows to switch to a new driver, Windows will first call LoadLibrary on the new driver and call ValidateMode to verify that the new color depth/resolution is possible.
Display drivers must use the name "ValidateMode" in the .DEF file; since Windows dyna-links to this function by name, not by ordinal.
Ordinal 700 is the recommended value for this function.
See also DISPLAYINFO