GA_setActiveDevice

Sets the active display device for multiple display devices

Declaration

ibool NAPI GA_setActiveDevice(
N_int32 deviceIndex)

Prototype In

snap/graphics.h

Parameters

deviceIndex | Index of device to make active

Return Value

True on success, false on error.

Description

This function allows the application to switch between the primary and secondary display controllers, making one of the controllers the active controller. When a controller is the active controller it will function as though it is the only display controller in the system. You can also select a 'mixed' mode of operation by passing in the DEVICE_MIXED_MODED parameter, which fully enables the primary display controller but only enables the secondary display controllers memory mappings. If mixed mode is selected, it is the responsibility of the calling application to ensure that the secondary controller's VGA memory spaces are disabled before setting this mode to avoid conflicts between the controllers.

The device numbering starts at 0 for the primary display controller, and increments by one for each supports display controller. Ie: the second controller is device 1 while the third controller is device 2 etc. There is no limit of the number of devices supported, other than the number of PCI/AGP slots available in a particular machine.

See Also

GA_loadDriver

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