User`s guide

FUNCTIONS
SDK SECTION 11
Page 173
OA_AddMode
unsigned int WINAPI OA_AddMode (char* ModeName, unsigned int ModeNameLen, char *
ModeDescription, unsigned int ModeDescriptionLen)
Description
This function will add a mode name and description to memory. Note that this will not add
the mode to file, a subsequent call to OA_WriteToFile must be made.
Parameters
char* ModeName: A name for the mode to be defined.
unsigned int ModeNameLen: Mode name string length.
char* modeDescription: A description of the user defined mode.
unsigned int ModeDescriptionLen: Mode Description string length.
Return
unsigned int
DRV_SUCCESS
DRV_P1INVALID
DRV_P3INVALID
DRV_OA_INVALID_STRING_LENGTH
DRV_OA_INVALID_NAMING
DRV_OA_MODE_BUFFER_FULL
DRV_OA_INVALID_CHARS_IN_NAME
DRV_OA_MODE_ALREADY_EXISTS
DRV_OA_INVALID_CHARS_IN_NAME
All parameters accepted
Null mode name.
Null mode description.
One or more parameters have an invalid
length, i.e. > 255.
Mode and description have the same name,
this is not valid.
Number of modes exceeds limit.
Mode name and/or description contain
invalid characters.
Mode name already exists in the file.
Invalid charcters in Mode Name or Mode
Description
See also
OA_DeleteMode, OA_WriteToFile
OA_DeleteMode
unsigned int WINAPI OA_DeleteMode (const char* const ModeName, unsigned int ModeNameLen)
Description
This function will remove a mode from memory. To permanently remove a mode from file,
call OA_WriteToFile after OA_DeleteMode. The Preset file will not be affected.
Parameters
const char* const ModeName: The name of the mode to be removed.
unsigned int ModeNameLen: Mode name string length.
Return
unsigned int
DRV_SUCCESS
DRV_P1INVALID
DRV_OA_INVALID_STRING_LENGTH
DRV_OA_MODE_DOES_NOT_EXIST
All parameters accepted
Null mode name.
The mode name parameter has an invalid
length, i.e. > 256.
Mode does not exist.
See also
OA_AddMode, OA_WriteToFile