ufm::sys 命名空間(Namespace)參考文件

系統功能相關的命名空間 更多...

複合項目
struct	Allocator
	[Interface] 記憶體分配器介面 更多...
class	DefaultAllocator
	預設記憶體分配器 更多...
class	EntryPoint
	應用程式進入點管理類別 更多...
struct	HardwareInfo
	[Interface] 硬體資訊介面 更多...
struct	Kernel
	[Interface] 系統核心介面 更多...
class	Stacker
	堆疊式記憶體分配器 更多...
class	Svcexec
class	Svchost
	系統服務主機 更多...
struct	SystemProvider
	系統資源提供者抽象介面 更多...
class	Thread
	執行緒類別 更多...
class	Timer
	系統計時器 更多...
class	TinyKernel

列舉型態
enum struct	ErrorCode : int {   NONE = 0 , HARD_FAULT = NONE + 1 , SYSTEM_ERROR = NONE + 2 , INSUFFICIENT_MEMORY = NONE + 3 ,   INSUFFICIENT_STACK_MEMORY = NONE + 4 , NULL_POINTER = NONE + 5 , ILLEGAL_ARGUMENT = NONE + 6 , WRITE_TO_READONLY_MEMORY = NONE + 7 ,   ARRAY_INDEX_OUT_OF_BOUNDS = NONE + 8 , NEGATIVE_ARRAYSIZE = NONE + 9 , NO_SUCH_ELEMENT = NONE + 10 , ARITHMETIC_ERROR = NONE + 11 ,   CLASS_NOT_FOUND = NONE + 12 , ILLEGAL_STATE = NONE + 13 , INDEX_OUT_OF_BOUNDS = NONE + 14 , IO_ERROR = NONE + 15 ,   INTERRUPTED = NONE + 16 , SECURITY_ERROR = NONE + 17 , TIMEOUT = NONE + 18 , UNSUPPORTED_OPERATION = NONE + 19 ,   TYPE_MISMATCH = NONE + 20 , CONCURRENT_MODIFICATION = NONE + 21 , STACK_OVERFLOW = NONE + 22 , CLASS_CAST_ERROR = NONE + 23 ,   ILLEGAL_ACCESS = NONE + 24 , NUMBER_FORMAT_ERROR = NONE + 25 , RESERVED = 0x7FFFFFFF }
	系統錯誤碼列舉 更多...
enum struct	ThreadPriority : int {   LOW = 8 , LOW1 = 8 + 1 , LOW2 = 8 + 2 , LOW3 = 8 + 3 ,   LOW4 = 8 + 4 , LOW5 = 8 + 5 , LOW6 = 8 + 6 , LOW7 = 8 + 7 ,   BELOW_NORMAL = 16 , BELOW_NORMAL1 = 16 + 1 , BELOW_NORMAL2 = 16 + 2 , BELOW_NORMAL3 = 16 + 3 ,   BELOW_NORMAL4 = 16 + 4 , BELOW_NORMAL5 = 16 + 5 , BELOW_NORMAL6 = 16 + 6 , BELOW_NORMAL7 = 16 + 7 ,   NORMAL = 24 , NORMAL1 = 24 + 1 , NORMAL2 = 24 + 2 , NORMAL3 = 24 + 3 ,   NORMAL4 = 24 + 4 , NORMAL5 = 24 + 5 , NORMAL6 = 24 + 6 , NORMAL7 = 24 + 7 ,   ABOVE_NORMAL = 32 , ABOVE_NORMAL1 = 32 + 1 , ABOVE_NORMAL2 = 32 + 2 , ABOVE_NORMAL3 = 32 + 3 ,   ABOVE_NORMAL4 = 32 + 4 , ABOVE_NORMAL5 = 32 + 5 , ABOVE_NORMAL6 = 32 + 6 , ABOVE_NORMAL7 = 32 + 7 ,   HIGH = 40 , HIGH1 = 40 + 1 , HIGH2 = 40 + 2 , HIGH3 = 40 + 3 ,   HIGH4 = 40 + 4 , HIGH5 = 40 + 5 , HIGH6 = 40 + 6 , HIGH7 = 40 + 7 ,   REALTIME = 48 , REALTIME1 = 48 + 1 , REALTIME2 = 48 + 2 , REALTIME3 = 48 + 3 ,   REALTIME4 = 48 + 4 , REALTIME5 = 48 + 5 , REALTIME6 = 48 + 6 , REALTIME7 = 48 + 7 ,   ERROR = -1 , RESERVED = 0x7FFFFFFF }
	執行緒優先權等級定義 更多...
enum struct	ThreadState : char {   INACTIVE , READY , RUNNING , BLOCKED ,   TERMINATED , ERROR }
	執行緒狀態枚舉 更多...

詳細描述

系統功能相關的命名空間

Copyright (c) 2020 ZxyKira All rights reserved.

SPDX-License-Identifier: MIT

列舉型態說明文件

ErrorCode

enum struct ufm::sys::ErrorCode : int

strong

系統錯誤碼列舉

此列舉定義了系統運行時可能遇到的各種錯誤狀態，用於統一錯誤處理和回報機制。

列舉值
NONE	預設無異常狀態，表示操作成功完成
HARD_FAULT	硬體錯誤，通常表示嚴重的硬體相關故障
SYSTEM_ERROR	系統錯誤，表示底層系統運行發生異常
INSUFFICIENT_MEMORY	系統內存不足，無法分配請求的記憶體空間
INSUFFICIENT_STACK_MEMORY	執行緒堆疊內存不足，可能導致呼叫深度受限
NULL_POINTER	存取空指標錯誤，嘗試對空指標進行操作
ILLEGAL_ARGUMENT	非法參數錯誤
WRITE_TO_READONLY_MEMORY	嘗試寫入唯讀記憶體區域，導致存取衝突
ARRAY_INDEX_OUT_OF_BOUNDS	陣列索引超出範圍
NEGATIVE_ARRAYSIZE	陣列大小為負數，無法創建負長度的陣列
NO_SUCH_ELEMENT	無此元素錯誤，通常在查找或操作集合時未找到指定元素
ARITHMETIC_ERROR	算術錯誤，例如除以零
CLASS_NOT_FOUND	找不到類別
ILLEGAL_STATE	非法狀態
INDEX_OUT_OF_BOUNDS	索引超出範圍，泛指各種集合
IO_ERROR	輸入/輸出錯誤
INTERRUPTED	執行緒中斷
SECURITY_ERROR	安全性錯誤
TIMEOUT	操作逾時
UNSUPPORTED_OPERATION	不支援的操作
TYPE_MISMATCH	型別不符
CONCURRENT_MODIFICATION	併發修改錯誤
STACK_OVERFLOW	堆疊溢位
CLASS_CAST_ERROR	類型轉換錯誤
ILLEGAL_ACCESS	非法存取
NUMBER_FORMAT_ERROR	數字格式錯誤
RESERVED	保留值，用於確保列舉型別使用32位整數表示

ThreadPriority

enum struct ufm::sys::ThreadPriority : int

strong

執行緒優先權等級定義

定義系統中執行緒可用的優先權等級，從低(LOW)到實時(REALTIME)， 每個主要等級之間有7個子等級供微調。優先權越高，執行緒獲得 處理器資源的機會越大，系統回應也越快。

優先權分級結構：

• 每個基本等級間隔為8單位值
• 每個基本等級內可細分為7個子等級(+1至+7)
• 數值越大代表優先權越高

常見使用場景：

• LOW: 背景任務、日誌記錄、統計資料收集等不緊急操作
• BELOW_NORMAL: 低優先度的用戶界面更新、非關鍵數據處理
• NORMAL: 一般應用程式和標準使用者互動任務
• ABOVE_NORMAL: 需較快回應的使用者互動、網絡通訊處理
• HIGH: 關鍵業務邏輯、需快速完成的數據處理
• REALTIME: 硬實時任務、關鍵硬體控制、精確定時操作

警告

謹慎使用REALTIME優先權，高優先權執行緒可能會阻止低優先權執行緒 取得CPU時間，導致系統其他部分無法正常工作或反應變慢。

列舉值
LOW	低優先權，適合背景和閒置任務
LOW1	低優先權+1
LOW2	低優先權+2
LOW3	低優先權+3
LOW4	低優先權+4
LOW5	低優先權+5
LOW6	低優先權+6
LOW7	低優先權+7
BELOW_NORMAL	低於標準優先權，適合不急迫的處理工作
BELOW_NORMAL1	低於標準優先權+1
BELOW_NORMAL2	低於標準優先權+2
BELOW_NORMAL3	低於標準優先權+3
BELOW_NORMAL4	低於標準優先權+4
BELOW_NORMAL5	低於標準優先權+5
BELOW_NORMAL6	低於標準優先權+6
BELOW_NORMAL7	低於標準優先權+7
NORMAL	標準優先權，適合一般應用程序和使用者互動任務
NORMAL1	標準優先權+1
NORMAL2	標準優先權+2
NORMAL3	標準優先權+3
NORMAL4	標準優先權+4
NORMAL5	標準優先權+5
NORMAL6	標準優先權+6
NORMAL7	標準優先權+7
ABOVE_NORMAL	高於標準優先權
ABOVE_NORMAL1	高於標準優先權+1
ABOVE_NORMAL2	高於標準優先權+2
ABOVE_NORMAL3	高於標準優先權+3
ABOVE_NORMAL4	高於標準優先權+4
ABOVE_NORMAL5	高於標準優先權+5
ABOVE_NORMAL6	高於標準優先權+6
ABOVE_NORMAL7	高於標準優先權+7
HIGH	高優先權
HIGH1	高優先權+1
HIGH2	高優先權+2
HIGH3	高優先權+3
HIGH4	高優先權+4
HIGH5	高優先權+5
HIGH6	高優先權+6
HIGH7	高優先權+7
REALTIME	實時優先權
REALTIME1	實時優先權+1
REALTIME2	實時優先權+2
REALTIME3	實時優先權+3
REALTIME4	實時優先權+4
REALTIME5	實時優先權+5
REALTIME6	實時優先權+6
REALTIME7	實時優先權+7
ERROR	優先權錯誤或無法確定狀態碼
RESERVED	保留值，防止編譯器優化枚舉大小，確保跨平台兼容性

ThreadState

enum struct ufm::sys::ThreadState : char

strong

執行緒狀態枚舉

描述系統中執行緒的各種可能狀態，用於執行緒管理和監控。 提供執行緒生命週期中從建立到終止的完整狀態識別。

列舉值
INACTIVE	非活動狀態 執行緒已建立但尚未啟動，或已完全終止。 此狀態下執行緒不消耗系統資源。
READY	就緒狀態 執行緒已準備好執行但等待被排程器選中。 所有必要的資源已分配，可隨時開始執行。
RUNNING	運行狀態 執行緒正在處理器上執行指令。 每個處理器核心同時只能有一個執行緒處於此狀態。
BLOCKED	阻塞狀態 執行緒暫時無法執行，等待某事件發生（如I/O完成或資源釋放）。 此狀態下執行緒不會被排程器選中執行。
TERMINATED	終止狀態 執行緒已結束執行但資源尚未完全釋放。 這是執行緒進入非活動狀態前的過渡階段。
ERROR	錯誤狀態 執行緒處於異常狀態或無法確定其狀態。 通常表示執行緒管理發生問題，需要系統干預。