User`s guide

FUNCTIONS
SDK SECTION 11
Page 178
OA_GetUserModeNames
unsigned int WINAPI OA_GetUserModeNames (char * ListOfModes)
Description
This function will return the available mode names from a User defined file. The mode
and the User defined file must exist. The user must allocate enough memory for all of the
acquisition parameters.
Parameters
char * ListOfModes: A user allocated array of characters for storage of the mode
names. Mode names will be delimited by a ‘,’.
Return
unsigned int
DRV_SUCCESS
DRV_P1INVALID
DRV_OA_NULL_ERROR
All parameters accepted.
Null list of modes.
Invalid pointer.
See also
OA_GetNumberOfUserModes
OA_Initialize
unsigned int WINAPI OA_Initialize (const char * const Filename, unsigned int FileNameLen)
Description
This function will initialise the OptAcquire settings from a Preset file and a User defined
file if it exists.
Parameters
char* const Filename: The name of a user xml file. If the file exists then data will
be read from the file. If the file does not exist the file name
may be used when the user calls WriteToFile().
unsigned int FileNameLen: The length of the filename.
Return
unsigned int
DRV_SUCCESS
DRV_P1INVALID
DRV_OA_CAMERA_NOT_SUPPORTED
DRV_OA_GET_CAMERA_ERROR
DRV_OA_INVALID_STRING_LENGTH
DRV_OA_ANDOR_FILE_NOT_LOADED
DRV_OA_USER_FILE_NOT_LOADED
DRV_OA_FILE_ACCESS_ERROR
DRV_OA_PRESET_AND_USER_FILE_N
OT_LOADED
All parameters accepted.
Null filename.
Camera not supported.
Unable to retrieve information about the
model of the Camera.
The parameter has an invalid length, i.e.
> 255.
Preset Andor file failed to load.
Supplied User file failed to load.
Failed to determine status of file.
Failed to load Andor and User file.
See also
OA_WriteToFile