summaryrefslogtreecommitdiff
path: root/common/src/tx_thread_entry_exit_notify.c
diff options
context:
space:
mode:
authorPProvost <[email protected]>2020-05-11 08:55:07 -0600
committerPProvost <[email protected]>2020-05-11 08:55:07 -0600
commit852421fda03a7722d7adb45b187235cd66fa264e (patch)
treeb117e1339a047347a3d7ebf3eeb1891168cc9b9b /common/src/tx_thread_entry_exit_notify.c
Initial commit
Diffstat (limited to 'common/src/tx_thread_entry_exit_notify.c')
-rw-r--r--common/src/tx_thread_entry_exit_notify.c109
1 files changed, 109 insertions, 0 deletions
diff --git a/common/src/tx_thread_entry_exit_notify.c b/common/src/tx_thread_entry_exit_notify.c
new file mode 100644
index 00000000..273864f2
--- /dev/null
+++ b/common/src/tx_thread_entry_exit_notify.c
@@ -0,0 +1,109 @@
+/**************************************************************************/
+/* */
+/* Copyright (c) Microsoft Corporation. All rights reserved. */
+/* */
+/* This software is licensed under the Microsoft Software License */
+/* Terms for Microsoft Azure RTOS. Full text of the license can be */
+/* found in the LICENSE file at https://aka.ms/AzureRTOS_EULA */
+/* and in the root directory of this software. */
+/* */
+/**************************************************************************/
+
+
+/**************************************************************************/
+/**************************************************************************/
+/** */
+/** ThreadX Component */
+/** */
+/** Thread */
+/** */
+/**************************************************************************/
+/**************************************************************************/
+
+#define TX_SOURCE_CODE
+
+
+/* Include necessary system files. */
+
+#include "tx_api.h"
+#include "tx_trace.h"
+#include "tx_thread.h"
+
+
+/**************************************************************************/
+/* */
+/* FUNCTION RELEASE */
+/* */
+/* _tx_thread_entry_exit_notify PORTABLE C */
+/* 6.0 */
+/* AUTHOR */
+/* */
+/* William E. Lamie, Microsoft Corporation */
+/* */
+/* DESCRIPTION */
+/* */
+/* This function registers an application entry/exit notification */
+/* callback routine for the application. Once registered, the callback */
+/* routine is called when the thread is initially entered and called */
+/* again when the thread completes or is terminated. */
+/* */
+/* INPUT */
+/* */
+/* thread_ptr Pointer to thread */
+/* thread_entry_exit_notify Pointer to notify callback */
+/* function, TX_NULL to disable*/
+/* */
+/* OUTPUT */
+/* */
+/* status Service return status */
+/* */
+/* CALLS */
+/* */
+/* None */
+/* */
+/* CALLED BY */
+/* */
+/* Application Code */
+/* */
+/* RELEASE HISTORY */
+/* */
+/* DATE NAME DESCRIPTION */
+/* */
+/* 05-19-2020 William E. Lamie Initial Version 6.0 */
+/* */
+/**************************************************************************/
+UINT _tx_thread_entry_exit_notify(TX_THREAD *thread_ptr, VOID (*thread_entry_exit_notify)(TX_THREAD *notify_thread_ptr, UINT id))
+{
+
+#ifdef TX_DISABLE_NOTIFY_CALLBACKS
+
+ TX_THREAD_NOT_USED(thread_ptr);
+ TX_THREAD_ENTRY_EXIT_NOTIFY_NOT_USED(thread_entry_exit_notify);
+
+ /* Feature is not enabled, return error. */
+ return(TX_FEATURE_NOT_ENABLED);
+#else
+
+TX_INTERRUPT_SAVE_AREA
+
+
+ /* Disable interrupts. */
+ TX_DISABLE
+
+ /* Make entry in event log. */
+ TX_TRACE_IN_LINE_INSERT(TX_TRACE_THREAD_ENTRY_EXIT_NOTIFY, thread_ptr, thread_ptr -> tx_thread_state, 0, 0, TX_TRACE_THREAD_EVENTS)
+
+ /* Make entry in event log. */
+ TX_EL_THREAD_ENTRY_EXIT_NOTIFY_INSERT
+
+ /* Setup thread entry/exit notification callback function. */
+ thread_ptr -> tx_thread_entry_exit_notify = thread_entry_exit_notify;
+
+ /* Restore interrupts. */
+ TX_RESTORE
+
+ /* Return success to caller. */
+ return(TX_SUCCESS);
+#endif
+}
+