IO_ProfilerGetStatsAndRestartCheckpoint / IO_ProfilerGetStatsAndEndCheckpoint

Syntax

#include <cafe/io_prof.h>

IO_PROF_RVAL IO_ProfilerGetStatsAndEndCheckpoint(u32 flags,
                                 u32 *duration,
                                 IO_ProfStat* stats,
                                 int *nstats);

IO_PROF_RVAL IO_ProfilerGetStatsAndRestartCheckpoint(u32 flags,
                                 u32 *duration,
                                 IO_ProfStat* stats,
                                 int *nstats);

Parameters

flags Currently unused, pass 0.
duration Duration (in microseconds) from the checkpoint start till now.
stats Pointer to an array of IO_ProfStat structures in which the profile data from IO channels is returned. IO_ProfStat structure is defined in cafe/io_profstat.h. stat buffer address and size must be IO_PROF_BUFFER_ALIGN aligned.
nstats A pointer holding size of stats array (i.e. number of IO_ProfStat structures in stats). Up on completion of the call, it contains how many of the buffers contain profiling data.

Return Values

IO_PROF_RVAL IO_PROF_RVAL_OK upon success, appropriate error code on failure.

Description

IO_ProfilerGetStatsAndEndCheckpoint End profiler checkpoint, get profiling data (for the time period from the previous checkpoint start till now).
IO_ProfilerGetStatsAndRestartCheckpoint End profiler checkpoint, get profiling data (for the time period from the previous checkpoint start till now) and start another profiling checkpoint. This is similar to calling IO_ProfilerGetStatsAndEndCheckpoint immediately followed by IO_ProfilerStartCheckpoint.

Do Not Call From

IO_ProfilerGetStatsAndEndCheckpoint

Callbacks Do not call this function from any callback function.
Interrupt handler Do not call this function from any interrupt handler.
Exception handler Do not call this function from any exception handler.
Production code Do not call this function in production code. It is available only for debugging purposes.

IO_ProfilerGetStatsAndRestartCheckpoint

Callbacks Do not call this function from any callback function.
Interrupt handler Do not call this function from any interrupt handler.
Exception handler Do not call this function from any exception handler.
Production code Do not call this function in production code. It is available only for debugging purposes.

See Also

IO_ProfilerStartCheckpoint

Revision History

2013/06/19 Initial version.


CONFIDENTIAL