GA_loadDriver

Loads a graphics driver file from disk for the specified device.

Declaration

GA_devCtx * NAPI GA_loadDriver(
    N_int32 deviceIndex,
    N_int32 shared)

Prototype In

snap/graphics.h

Parameters

deviceIndex

Index of device to load driver for (0 for primary controller)

shared

True if the device driver should be loaded into shared memory

 

Return Value

Pointer to the loaded graphics driver, or NULL on error.

Description

Loads the driver file from disk and intialises the device context ready for use. If the driver file cannot be found, or the driver does not detect the installed hardware, we return NULL and the application can get the status code with the N_status function.

Note that for multiple controller support you can specify the device you want to load the graphics driver for with the deviceIndex parameter. This parameter is 0 for the primary controller, 1 for the secondary controller and so on. The ordering of the controllers is determined by their enumeration order on the PCI bus, however device 0 is always the primary controller.

See Also

GA_setActiveDevice, GA_unloadDriver, N_status, N_errorMsg, GA_isSharedDriverLoaded

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