A.8.47. CADI::CADIExecGetLoadedApplication()

This gets a list of image filenames that are currently loaded in the target.

virtual CADIReturn_t CADI::CADIExecGetLoadedApplications(uint32_t startIndex,
                               uint32_t desiredNumberOfApplications,
                               uint32_t *actualNumberOfApplicatiosReturnedOut,
                               char *filenamesOut,
                               uint32_t filenameLength,
                               char *parametersOut,
                               uint32_t parametersLength) = 0;

where:

startIndex

is the starting index in the list of filenames.

desiredNumberOfApplications

is the required number of applications (filename + parameters).

actualNumberOfApplicatiosReturnedOut

is the number of applications (filenames + parameters) that are valid in filenamesOut and parametersOut.

filenamesOut

is a buffer of length [desiredNumberOfFilenames *filenamLength], the Nth filename returned starts at offset N*filenameLength. The file name strings are zero terminated.

filenameLength

is the maximum length of a single filename including terminating 0. Longer filenames are truncated. All returned filenames must be 0 terminated. If one of the returned filenames has the length filenameLength-1 then filenameLength was too short and must be redone. The target decides whether or not it can keep information of more than one file.

parametersOut

is a buffer of length [desiredNumberOfApplications *parametersLength], the Nth parameter returned starts at offset N*parametersLength. Each parameter string is zero terminated. The target decides whether or not it can keep information for more than one file.

parametersLength

is the maximum length of a single parameters string including terminating 0. Longer parameters are truncated. All returned parameters must always be 0 terminated. If one of the returned parameters has the length parametersLength-1 then parametersLength was too short and must be redone. The target decides whether or not it can keep information for more than one file.

Copyright © 2008-2014 ARM. All rights reserved.ARM DUI 0444M
Non-ConfidentialID051314