Supported Browsers Home   
PE_loadLibraryMGL Previous   
REF2D_queryFunctions Next   
External Functions Up   

REF2D_loadDriver

Loads the 2D reference rasteriser device driver from disk.

Declaration

ibool NAPI REF2D_loadDriver(
    GA_devCtx _FAR_ *hwCtx,
    N_int32 bitsPerPixel,
    N_int32 shared,
    REF2D_driver _FAR_ *_FAR_ *drv,
    PE_MODULE _FAR_ *_FAR_ *hModRef,
    ulong _FAR_ *size)

Prototype In

snap/ref2d.h

Parameters

hwCtx

Hardware context to load driver for (if any)

bitsPerPixel

Pixel depth for driver to load (1,4,8,16,24 or 32)

shared

True to load into shared memory

drv

Pointer to the place to store loaded driver address

hModRef

Pointer to the place to store the load driver module handle

size

Pointer to the place to store the size of the driver

 

Return Value

True on success, false on failure.

Description

This function loads a copy of the SNAP 2D Reference Rasteriser for the specific color depth from disk. This function will always load the SNAP reference rasteriser driver from the public MGL directories, and should not be used to load the reference rasteriser driver for use with a hardware device context. Rather you should use the GA_loadRef2d function which automatically handles support for loading and initialising the Portait Display and Multi-Controller SNAP filter drivers.

However if you wish to load and use the SNAP reference rasteriser for drawing to system memory bitmaps, you can use this function instead.

See Also

GA_loadRef2d, REF2D_unloadDriver

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