User`s guide

FUNCTIONS

SDK SECTION 11

Page 136

GetImages

unsigned int WINAPI GetImages(long first, long last, at_32* arr, unsigned long size, long* validfirst,

long* validlast)

Description

This function will update the data array with the specified series of images from the

circular buffer. If the specified series is out of range (i.e. the images have been

overwritten or have not yet been acquired then an error will be returned.

Parameters

long first: index of first image in buffer to retrieve.

long last: index of last image in buffer to retrieve.

at_32* arr: pointer to data storage allocated by the user.

unsigned long size: total number of pixels.

long* validfirst: index of the first valid image.

long* validlast: index of the last valid image.

Return

unsigned int

DRV_SUCCESS

DRV_NOT_INITIALIZED

DRV_ERROR_ACK

DRV_GENERAL_ERRORS

DRV_P3INVALID

DRV_P4INVALID

DRV_NO_NEW_DATA

Images have been copied into array.

System not initialized.

Unable to communicate with card.

The series is out of range.

Invalid pointer (i.e. NULL).

Array size is incorrect.

There is no new data yet.