generated from Template/H563ZI-HAL-CMake-Template
	开启 ThreadX
This commit is contained in:
		
							
								
								
									
										162
									
								
								Middlewares/ST/threadx/common/src/txe_queue_receive.c
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										162
									
								
								Middlewares/ST/threadx/common/src/txe_queue_receive.c
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,162 @@ | ||||
| /**************************************************************************/ | ||||
| /*                                                                        */ | ||||
| /*       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                                                     */ | ||||
| /**                                                                       */ | ||||
| /**   Queue                                                               */ | ||||
| /**                                                                       */ | ||||
| /**************************************************************************/ | ||||
| /**************************************************************************/ | ||||
|  | ||||
| #define TX_SOURCE_CODE | ||||
|  | ||||
|  | ||||
| /* Include necessary system files.  */ | ||||
|  | ||||
| #include "tx_api.h" | ||||
| #include "tx_timer.h" | ||||
| #include "tx_thread.h" | ||||
| #include "tx_queue.h" | ||||
|  | ||||
|  | ||||
| /**************************************************************************/ | ||||
| /*                                                                        */ | ||||
| /*  FUNCTION                                               RELEASE        */ | ||||
| /*                                                                        */ | ||||
| /*    _txe_queue_receive                                  PORTABLE C      */ | ||||
| /*                                                           6.1          */ | ||||
| /*  AUTHOR                                                                */ | ||||
| /*                                                                        */ | ||||
| /*    William E. Lamie, Microsoft Corporation                             */ | ||||
| /*                                                                        */ | ||||
| /*  DESCRIPTION                                                           */ | ||||
| /*                                                                        */ | ||||
| /*    This function checks for errors in the queue receive function call. */ | ||||
| /*                                                                        */ | ||||
| /*  INPUT                                                                 */ | ||||
| /*                                                                        */ | ||||
| /*    queue_ptr                         Pointer to queue control block    */ | ||||
| /*    destination_ptr                   Pointer to message destination    */ | ||||
| /*                                        **** MUST BE LARGE ENOUGH TO    */ | ||||
| /*                                             HOLD MESSAGE ****          */ | ||||
| /*    wait_option                       Suspension option                 */ | ||||
| /*                                                                        */ | ||||
| /*  OUTPUT                                                                */ | ||||
| /*                                                                        */ | ||||
| /*    TX_QUEUE_ERROR                    Invalid queue pointer             */ | ||||
| /*    TX_PTR_ERROR                      Invalid destination pointer (NULL)*/ | ||||
| /*    TX_WAIT_ERROR                     Invalid wait option               */ | ||||
| /*    status                            Actual completion status          */ | ||||
| /*                                                                        */ | ||||
| /*  CALLS                                                                 */ | ||||
| /*                                                                        */ | ||||
| /*    _tx_queue_receive                 Actual queue receive function     */ | ||||
| /*                                                                        */ | ||||
| /*  CALLED BY                                                             */ | ||||
| /*                                                                        */ | ||||
| /*    Application Code                                                    */ | ||||
| /*                                                                        */ | ||||
| /*  RELEASE HISTORY                                                       */ | ||||
| /*                                                                        */ | ||||
| /*    DATE              NAME                      DESCRIPTION             */ | ||||
| /*                                                                        */ | ||||
| /*  05-19-2020     William E. Lamie         Initial Version 6.0           */ | ||||
| /*  09-30-2020     Yuxin Zhou               Modified comment(s),          */ | ||||
| /*                                            resulting in version 6.1    */ | ||||
| /*                                                                        */ | ||||
| /**************************************************************************/ | ||||
| UINT  _txe_queue_receive(TX_QUEUE *queue_ptr, VOID *destination_ptr, ULONG wait_option) | ||||
| { | ||||
|  | ||||
| UINT        status; | ||||
|  | ||||
| #ifndef TX_TIMER_PROCESS_IN_ISR | ||||
| TX_THREAD   *current_thread; | ||||
| #endif | ||||
|  | ||||
|  | ||||
|     /* Default status to success.  */ | ||||
|     status =  TX_SUCCESS; | ||||
|  | ||||
|     /* Check for an invalid queue pointer.  */ | ||||
|     if (queue_ptr == TX_NULL) | ||||
|     { | ||||
|  | ||||
|         /* Queue pointer is invalid, return appropriate error code.  */ | ||||
|         status =  TX_QUEUE_ERROR; | ||||
|     } | ||||
|  | ||||
|     /* Now check for invalid queue ID.  */ | ||||
|     else if (queue_ptr -> tx_queue_id != TX_QUEUE_ID) | ||||
|     { | ||||
|  | ||||
|         /* Queue pointer is invalid, return appropriate error code.  */ | ||||
|         status =  TX_QUEUE_ERROR; | ||||
|     } | ||||
|  | ||||
|     /* Check for an invalid destination for message.  */ | ||||
|     else if (destination_ptr == TX_NULL) | ||||
|     { | ||||
|  | ||||
|         /* Null destination pointer, return appropriate error.  */ | ||||
|         status =  TX_PTR_ERROR; | ||||
|     } | ||||
|     else | ||||
|     { | ||||
|  | ||||
|         /* Check for a wait option error.  Only threads are allowed any form of | ||||
|            suspension.  */ | ||||
|         if (wait_option != TX_NO_WAIT) | ||||
|         { | ||||
|  | ||||
|             /* Is the call from an ISR or Initialization?  */ | ||||
|             if (TX_THREAD_GET_SYSTEM_STATE() != ((ULONG) 0)) | ||||
|             { | ||||
|  | ||||
|                 /* A non-thread is trying to suspend, return appropriate error code.  */ | ||||
|                 status =  TX_WAIT_ERROR; | ||||
|             } | ||||
|  | ||||
| #ifndef TX_TIMER_PROCESS_IN_ISR | ||||
|             else | ||||
|             { | ||||
|  | ||||
|                 /* Pickup thread pointer.  */ | ||||
|                 TX_THREAD_GET_CURRENT(current_thread) | ||||
|  | ||||
|                 /* Is the current thread the timer thread?  */ | ||||
|                 if (current_thread == &_tx_timer_thread) | ||||
|                 { | ||||
|  | ||||
|                     /* A non-thread is trying to suspend, return appropriate error code.  */ | ||||
|                     status =  TX_WAIT_ERROR; | ||||
|                 } | ||||
|             } | ||||
| #endif | ||||
|         } | ||||
|     } | ||||
|  | ||||
|     /* Determine if everything is okay.  */ | ||||
|     if (status == TX_SUCCESS) | ||||
|     { | ||||
|  | ||||
|         /* Call actual queue receive function.  */ | ||||
|         status =  _tx_queue_receive(queue_ptr, destination_ptr, wait_option); | ||||
|     } | ||||
|  | ||||
|     /* Return completion status.  */ | ||||
|     return(status); | ||||
| } | ||||
|  | ||||
		Reference in New Issue
	
	Block a user