CMSIS-RTOS2 文檔翻譯 之 參考(RTX5 特定的 API 之 事件功能(事件標誌函數))

事件標誌函數

事件功能

事件標誌函數生成的事件。更多...

函數

void  EvrRtxEventFlagsError (osEventFlagsId_t ef_id, int32_t status)
  事件標誌上的事件錯誤(錯誤)更多...
 
void  EvrRtxEventFlagsNew (const osEventFlagsAttr_t *attr)
  事件標誌上的事件創建和初始化(API)更多...
 
void  EvrRtxEventFlagsCreated (osEventFlagsId_t ef_id, const char *name)
  成功的事件標誌上的事件創建(Op)更多...
 
void  EvrRtxEventFlagsGetName (osEventFlagsId_t ef_id, const char *name)
  事件標誌上的事件名稱檢索(API)更多...
 
void  EvrRtxEventFlagsWaitTimeout (osEventFlagsId_t ef_id)
  事件標誌等待超時事件(Op)更多...
 
void  EvrRtxEventFlagsDelete (osEventFlagsId_t ef_id)
  事件標誌上的事件刪除(API)更多...
 
void  EvrRtxEventFlagsDestroyed (osEventFlagsId_t ef_id)
  成功事件標誌上的事件刪除(操作)更多...
 

 

描述

函數文檔

void EvrRtxEventFlagsError ( osEventFlagsId_t  ef_id,
    int32_t  status 
  )    

參數

[in] ef_id 事件標誌由 osEventFlagsNew 獲取的 ID 或 ID 未知時爲 NULL。
[in] status 擴展執行狀態。

事件標誌例程由於錯誤而完成執行時,會生成事件 EventFlagsError

status 參數指示執行狀態,可以是 osStatus_t 代碼之一,也可以是下表中彙總的擴展執行狀態代碼之一。

擴展狀態代碼 描述
osRtxErrorKernelNotReady 內核調度程序未處於就緒狀態。
osRtxErrorKernelNotRunning 內核調度程序沒有執行 - 沒有正在運行的線程。
osRtxErrorInvalidControlBlock 指定了具有無效對齊或大小的對象控制塊。
osRtxErrorInvalidDataMemory 指定了無效對齊或大小的對象數據存儲器。
osRtxErrorInvalidThreadStack 指定了無效對齊或大小的線程堆棧內存。
osRtxErrorInvalidPriority 指定了無效的線程優先級。
osRtxErrorThreadNotJoinable 指定的線程不可連接。
osRtxErrorMutexNotOwned 指定的互斥鎖不歸當前運行的線程所有。
osRtxErrorMutexNotLocked 指定的互斥鎖未鎖定。
osRtxErrorMutexLockLimit 達到的最大遞歸互斥鎖數。
osRtxErrorSemaphoreCountLimit 達到了信號量計數限制。
osRtxErrorTZ_InitContext_S 安全上下文內存系統初始化失敗
osRtxErrorTZ_AllocContext_S 安全上下文內存分配失敗。
osRtxErrorTZ_FreeContext_S 安全上下文內存釋放失敗。
osRtxErrorTZ_LoadContext_S 安全上下文加載失敗。
osRtxErrorTZ_SaveContext_S 安全上下文保存失敗。

事件記錄器中的值顯示:

  • ef_id : 事件標誌 ID。
  • status : 執行狀態代碼。

 

void EvrRtxEventFlagsNew ( const osEventFlagsAttr_t attr )  

參數

[in] attr 事件標誌屬性。

調用函數 osEventFlagsNew 時會生成事件 EventFlagsNew

事件記錄器中的值顯示:

  • attr : 事件標誌屬性的內存地址,如果未指定,則爲 0。

如果在 API 調用中提供了事件標誌屬性,則它們也會在事件記錄器中詳細說明。

 

void EvrRtxEventFlagsCreated ( osEventFlagsId_t  ef_id,
    const char *  name 
  )    

參數

[in] ef_id 事件標誌由 osEventFlagsNew 獲取的 ID。
[in] name 指向事件標誌對象名稱的指針。

當函數 osEventFlagsNew 成功創建事件標誌對象時,將生成 EventFlagsCreated 事件。

事件記錄器中的值顯示:

  • ef_id : 事件標誌 ID。

 

void EvrRtxEventFlagsGetName ( osEventFlagsId_t  ef_id,
    const char *  name 
  )    

參數

[in] ef_id 事件標誌由 osEventFlagsNew 獲取的 ID。
[in] name 指向事件標誌對象名稱的指針。

調用函數 osEventFlagsGetName 並且其執行結果已知時,將生成 EventFlagsGetName 事件。

事件記錄器中的值顯示:

  • ef_id : 事件標誌 ID。
  • name : 檢索名稱字符串的內存地址(如果發生故障,則爲 0)。

 

void EvrRtxEventFlagsWaitTimeout ( osEventFlagsId_t  ef_id )  

參數

[in] ef_id 事件標誌由 osEventFlagsNew 獲取的 ID。

當等待事件標誌變爲信號時,由於過期的等待超時而中止,則生成事件 EventFlagsWaitTimeout

事件記錄器中的值顯示:

  • ef_id : 事件標誌 ID。

 

void EvrRtxEventFlagsDelete ( osEventFlagsId_t  ef_id )  

參數

[in] ef_id 事件標誌由 osEventFlagsNew 獲取的 ID。

調用函數 osEventFlagsDelete 時會生成事件 EventFlagsDelete

事件記錄器中的值顯示:

  • ef_id : 事件標誌 ID。

 

void EvrRtxEventFlagsDestroyed ( osEventFlagsId_t  ef_id )  

參數

[in] ef_id 事件標誌由 osEventFlagsNew 獲取的 ID。

當函數 osEventFlagsDelete 成功刪除事件標誌對象時,將生成 EventFlagsDestroyed 事件。

事件記錄器中的值顯示:

  • ef_id : 事件標誌 ID。
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章