1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
|
/***************************************************************************
* Copyright (c) 2024 Microsoft Corporation
* Copyright (c) 2025-present Eclipse ThreadX Contributors
*
* This program and the accompanying materials are made available under the
* terms of the MIT License which is available at
* https://opensource.org/licenses/MIT.
*
* SPDX-License-Identifier: MIT
**************************************************************************/
/**************************************************************************/
/**************************************************************************/
/** */
/** NetX Duo Component */
/** */
/** Trace */
/** */
/**************************************************************************/
/**************************************************************************/
#ifndef NX_SOURCE_CODE
#define NX_SOURCE_CODE
#endif
/* Include necessary system files. */
#include "nx_api.h"
#ifdef TX_ENABLE_EVENT_TRACE
/**************************************************************************/
/* */
/* FUNCTION RELEASE */
/* */
/* _nx_trace_event_insert PORTABLE C */
/* 6.4.3 */
/* AUTHOR */
/* */
/* Yuxin Zhou, Microsoft Corporation */
/* */
/* DESCRIPTION */
/* */
/* This function inserts a NetX Duo event into the current trace */
/* buffer. */
/* */
/* INPUT */
/* */
/* event_id User Event ID */
/* info_field_1 First information field */
/* info_field_2 First information field */
/* info_field_3 First information field */
/* info_field_4 First information field */
/* current_event Current event pointer for */
/* post event update */
/* current_timestamp Timestamp for post event */
/* update */
/* */
/* OUTPUT */
/* */
/* None */
/* */
/* CALLS */
/* */
/* None */
/* */
/* CALLED BY */
/* */
/* Internal NetX Duo Functions */
/* */
/**************************************************************************/
VOID _nx_trace_event_insert(ULONG event_id, ULONG info_field_1, ULONG info_field_2, ULONG info_field_3, ULONG info_field_4, ULONG filter, TX_TRACE_BUFFER_ENTRY **current_event, ULONG *current_timestamp)
{
TX_INTERRUPT_SAVE_AREA
TX_TRACE_BUFFER_ENTRY *event;
ULONG timestamp;
/* Disable interrupts. */
TX_DISABLE
/* Pickup the current event. */
event = _tx_trace_buffer_current_ptr;
/* Insert this event into the trace buffer. */
TX_TRACE_IN_LINE_INSERT(event_id, info_field_1, info_field_2, info_field_3, info_field_4, filter);
/* Initialize the timestamp to 0. */
timestamp = 0;
/* Determine if the event was inserted. */
if (event)
{
/* Was the event inserted? */
if (event -> tx_trace_buffer_entry_event_id == event_id)
{
/* Yes, the event was inserted in the event trace so pickup the timestamp. */
timestamp = event -> tx_trace_buffer_entry_time_stamp;
}
else
{
/* Event was not inserted, simply set the event pointer to NULL. */
event = NX_NULL;
}
}
/* Now determine if the caller requested the current event. */
if (current_event)
{
/* Yes, return the event pointer of potential subsequent update. */
*current_event = event;
}
/* Now determine if the current timestamp was requested. */
if (current_timestamp)
{
/* Yes, return the current timestamp. */
*current_timestamp = timestamp;
}
/* Restore interrupts. */
TX_RESTORE
}
#endif
|
