Percepio Trace Recorder v4.8.0.hotfix1
Loading...
Searching...
No Matches
Trace Entry Table APIs

Data Structures

struct  TraceEntry
 

Typedefs

typedef struct TraceEntry TraceEntry_t
 

Functions

traceResult xTraceEntryCreate (TraceEntryHandle_t *pxEntryHandle)
 Creates trace entry.
 
traceResult xTraceEntryDelete (TraceEntryHandle_t xEntryHandle)
 Deletes trace entry.
 
traceResult xTraceEntryFind (const void *const pvAddress, TraceEntryHandle_t *pxEntryHandle)
 Finds trace entry mapped to object address.
 
traceResult xTraceEntryGetCount (uint32_t *puiCount)
 Gets the number of entries in the trace entry table.
 
traceResult xTraceEntryGetAtIndex (uint32_t index, TraceEntryHandle_t *pxEntryHandle)
 Gets trace table entry at index.
 
traceResult xTraceEntrySetSymbol (const TraceEntryHandle_t xEntryHandle, const char *szSymbol, uint32_t uiLength)
 Sets symbol for entry.
 

Detailed Description

Typedef Documentation

◆ TraceEntry_t

typedef struct TraceEntry TraceEntry_t

Trace Entry Structure

Function Documentation

◆ xTraceEntryCreate()

traceResult xTraceEntryCreate ( TraceEntryHandle_t *  pxEntryHandle)

Creates trace entry.

Parameters
[out]pxEntryHandlePointer to uninitialized trace entry handle.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceEntryDelete()

traceResult xTraceEntryDelete ( TraceEntryHandle_t  xEntryHandle)

Deletes trace entry.

Parameters
[in]xEntryHandlePointer to initialized trace entry handle.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceEntryFind()

traceResult xTraceEntryFind ( const void *const  pvAddress,
TraceEntryHandle_t *  pxEntryHandle 
)

Finds trace entry mapped to object address.

Parameters
[in]pvAddressAddress of object.
[out]pxEntryHandlePointer to uninitialized trace entry handle.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceEntryGetAtIndex()

traceResult xTraceEntryGetAtIndex ( uint32_t  index,
TraceEntryHandle_t *  pxEntryHandle 
)

Gets trace table entry at index.

Parameters
[in]indexEntry index.
[out]pxEntryHandlePointer to uninitialized trace entry handle.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceEntryGetCount()

traceResult xTraceEntryGetCount ( uint32_t *  puiCount)

Gets the number of entries in the trace entry table.

Parameters
[out]puiCountCount.
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess

◆ xTraceEntrySetSymbol()

traceResult xTraceEntrySetSymbol ( const TraceEntryHandle_t  xEntryHandle,
const char *  szSymbol,
uint32_t  uiLength 
)

Sets symbol for entry.

Parameters
[in]xEntryHandlePointer to initialized trace entry handle.
[in]szSymbolPointer to symbol string, set by function
[in]uiLengthSymbol length
Return values
TRC_FAILFailure
TRC_SUCCESSSuccess