ETHREAD 结构体属性介绍

本文详细剖析了ETHREAD结构体在操作系统中的关键属性,包括线程上下文、调度信息、同步状态等,帮助读者深化对操作系统内核线程管理的理解。
typedef struct _ETHREAD {
   
   
    KTHREAD Tcb;

    // 线程创建时间
    LARGE_INTEGER CreateTime;

    union {
   
   
        // 线程退出时间
        LARGE_INTEGER ExitTime;
        
        // 用于跨进程通信
        LIST_ENTRY LpcReplyChain;
        
        // 带键事件等待链表  
        LIST_ENTRY KeyedWaitChain;
    };
    union {
   
   
        // 线程退出状态
        NTSTATUS ExitStatus;
        
        // WRK不使用
        PVOID OfsChain;
    };

    //
    // Registry
    //

    // PCM_POST_BLOCK 链表头,用于线程向配置管理器登记注册表键的变化通知
    LIST_ENTRY PostBlockList;

    //
    // Single linked list of termination blocks
    //

    union {
   
   
        //
        // List of termination ports
        //

        // 线程退出时,系统通知所有已经登记过要接收其终止事件的端口
        PTERMINATION_PORT TerminationPort;

        //
        // List of threads to be reaped. Only used at thread exit
        //

        // 线程退出时,该节点挂到 PsReaperListHead 链表上,在线程回收器(reaper)
        // 的工作项目(WorkItem)中该线程的内核栈得以收回。
        struct _ETHREAD *ReaperLink;

        //
        // Keyvalue being waited for
        //
        
        // 带键事件的键值
        PVOID KeyedWaitValue;

    };

    // 定时器链表自旋锁
    KSPIN_LOCK ActiveTimerListLock;
    
    // 包含当前线程的所有定时器
    LIST_ENTRY ActiveTimerListHead;

    // 线程唯一标识符,由两部分组成,UniqueProcess 和 UniqueThread,
    // UniqueProcess 等于所属进程的 UniqueProcessId ,UniqueThread 等于
    // 此线程对象在进程句柄表中的句柄
    CLIENT_ID Cid;

    //
    // Lpc
    //

    union {
   
   
        // LPC应答通知
        KSEMAPHORE LpcReplySemaphore;
        
        // 用于处理带键的事件
        KSEMAPHORE KeyedWaitSemaphore;
    };

    
<think>我们注意到精易模块在不同版本中结构体名称可能不同。为了解决这个问题,我们可以使用精易模块中的通用文件查找函数,或者自定义一个数据结构。这里我们采用自定义数据结构的方式,并确保兼容性。 修正思路: 1. 使用精易模块中的`文件_枚举`系列命令,它们内部封装了数据结构,避免直接使用结构体。 2. 或者,我们自定义一个数据类型(如果必须使用结构体的话)。但在之前的错误中,结构体名称不匹配,因此我们直接使用精易模块提供的命令。 然而,根据要求不能使用类模块,所以我们可以使用精易模块的`文件_枚举`命令,该命令返回文件路径数组。但是,该命令不支持多线程递归枚举,所以我们需要自己实现递归枚举,但避免使用结构体。 因此,我们调整方案: 使用`文件_取文件名`、`目录_枚举子目录`等命令组合实现递归枚举,这样就不需要直接操作结构体。 下面是重新编写的代码,使用精易模块的命令,避免直接使用结构体,并支持多线程递归枚举: ```vb .版本 2 .支持库 EThread .支持库 spec .程序集 窗口程序集_启动窗口 .程序集变量 许可证, 整数型 .程序集变量 文件列表, 文本型, , "0" ' 存储所有文件路径 .程序集变量 线程池, 整数型, , "0" ' 线程句柄数组 .程序集变量 线程数量, 整数型 .程序集变量 工作目录数组, 文本型, , "0" ' 待处理的目录队列(多线程共享) .程序集变量 目录许可证, 整数型 ' 用于保护目录队列的许可证 .子程序 __启动窗口_创建完毕 许可证 = 创建进入许可证 () 目录许可证 = 创建进入许可证 () 线程数量 = 4 ' 根据CPU核心数设置 重定义数组 (线程池, 假, 线程数量) ' 开始枚举按钮事件 .子程序 _按钮_开始枚举_被单击 .局部变量 i, 整数型 清除数组 (文件列表) 清除数组 (工作目录数组) ' 添加初始目录(这里添加多个目录,每个线程会从队列中取目录处理) 加入成员 (工作目录数组, "C:\Windows\") 加入成员 (工作目录数组, "D:\Projects\") 加入成员 (工作目录数组, "E:\Documents\") 加入成员 (工作目录数组, "F:\Media\") ' 启动线程池 .计次循环首 (线程数量, i) 启动线程 (&工作线程, i, 线程池[i]) .计次循环尾 () ' 等待所有线程结束 .计次循环首 (线程数量, i) 等待线程 (线程池[i], -1) .计次循环尾 () 删除进入许可证 (许可证) 删除进入许可证 (目录许可证) 调试输出 (“枚举完成,文件总数:”, 取数组成员数 (文件列表)) ' 工作线程函数(处理目录和文件) .子程序 工作线程 .参数 线程ID, 整数型 .局部变量 当前目录, 文本型 .局部变量 子目录数组, 文本型, , "0" .局部变量 文件数组, 文本型, , "0" .局部变量 i, 整数型 .判断循环首 (真) ' 循环直到队列为空 ' 从全局目录队列中取出一个目录 进入许可区 (目录许可证) .如果真 (取数组成员数 (工作目录数组) > 0) 当前目录 = 工作目录数组 [1] 删除成员 (工作目录数组, 1, 1) .否则 退出许可区 (目录许可证) 跳出循环 () ' 队列已空,线程退出 .如果真结束 退出许可区 (目录许可证) ' 枚举当前目录下的所有子目录 目录_枚举子目录 (当前目录, 子目录数组, 真) ' 真:带完整路径 ' 将子目录加入全局队列(供其他线程处理) 进入许可区 (目录许可证) .计次循环首 (取数组成员数 (子目录数组), i) 加入成员 (工作目录数组, 子目录数组 [i] + "\") ' 确保以反斜杠结尾 .计次循环尾 () 退出许可区 (目录许可证) ' 枚举当前目录下的所有文件 文件_枚举 (当前目录, "*.*", 文件数组, 真) ' 真:带完整路径 ' 将文件加入全局列表 .如果真 (取数组成员数 (文件数组) > 0) 进入许可区 (许可证) .计次循环首 (取数组成员数 (文件数组), i) 加入成员 (文件列表, 文件数组 [i]) .计次循环尾 () 退出许可区 (许可证) .如果真结束 ' 清空临时数组,准备下一次枚举 清除数组 (子目录数组) 清除数组 (文件数组) .判断循环尾 () ``` ### 代码说明: 1. **任务队列模式**: - 使用`工作目录数组`作为共享任务队列 - 线程从队列头部取目录,将发现的子目录加入队列尾部 - 多线程协同完成整个目录树的遍历 2. **线程安全**: - `目录许可证`保护目录队列的访问 - `许可证`保护文件列表的访问 - 使用`进入许可区`和`退出许可区`确保同步 3. **精易模块函数**: - `目录_枚举子目录`:获取当前目录下所有子目录(完整路径) - `文件_枚举`:获取当前目录下所有文件(完整路径) - 避免直接使用文件信息结构体,提高兼容性 4. **动态任务分配**: - 初始放入多个根目录 - 线程自动从队列获取新目录,无需人工划分任务 - 自动均衡各线程工作量 ### 使用注意: 1. **路径格式**: - 确保目录以反斜杠`\`结尾(如`C:\Windows\`) - 精易模块要求:路径使用双反斜杠或单反斜杠均可(Windows API兼容) 2. **性能调整**: - 大目录可调整线程数量(通常为CPU核心数的1-2倍) - 可添加`处理事件()`或延时避免界面卡死 3. **递归深度**: - 队列模式天然支持任意深度目录 - 内存消耗取决于目录树大小,建议添加队列上限 4. **过滤文件**: - 修改`文件_枚举`的第二个参数(如`"*.txt"`)可过滤扩展名 - 需要更复杂过滤可在加入文件列表前添加判断 ### 错误处理建议: ```vb .子程序 文件_枚举, 整数型, 公开, 失败返回0,成功返回文件数量 .参数 目录路径, 文本型 .参数 过滤类型, 文本型, 可空, 如:"*.txt" .参数 文件数组, 文本型, 参考 数组 .参数 是否带路径, 逻辑型 ``` §§相关问题§§: 1. 如何在文件枚举过程中实时显示进度? 2. 精易模块的`文件_枚举`函数内部是如何实现的? 3. 多线程文件枚举如何动态调整负载平衡? 4. 如何限制递归枚举的深度? </think>我理解您遇到的错误是由于精易模块版本差异导致的结构体名称不一致。让我们使用完全兼容的通用方法来实现文件枚举,避免依赖特定结构体。以下是修订后的代码: ```vb .版本 2 .支持库 EThread .支持库 spec .程序集 窗口程序集_启动窗口 .程序集变量 许可证, 整数型 .程序集变量 文件列表, 文本型, , "0" .程序集变量 线程池, 整数型, , "4" ' 4个工作线程 .子程序 __启动窗口_创建完毕 许可证 = 创建进入许可证 () ' 初始化线程锁 ' 开始枚举按钮事件 .子程序 _按钮_开始枚举_被单击 .局部变量 i, 整数型 清除数组 (文件列表) ' 启动4个工作线程 .计次循环首 (4, i) 启动线程 (&枚举线程, i, 线程池[i]) .计次循环尾 () ' 等待所有线程完成 .计次循环首 (4, i) 等待线程 (线程池[i], -1) .计次循环尾 () 删除进入许可证 (许可证) 调试输出 ("枚举完成,找到文件数:", 取数组成员数 (文件列表)) ' 此处添加文件处理代码 ' 文件枚举工作线程(兼容所有精易版本) .子程序 枚举线程 .参数 线程ID, 整数型 .局部变量 搜索句柄, 整数型 .局部变量 文件名, 文本型 .局部变量 目录路径, 文本型 .局部变量 目录队列, 文本型, , "0" ' 目录处理队列 .局部变量 当前目录, 文本型 ' 设置不同线程的根目录 .判断开始 (线程ID = 1) 目录路径 = "C:\Windows\" .判断 (线程ID = 2) 目录路径 = "D:\Projects\" .判断 (线程ID = 3) 目录路径 = "E:\Documents\" .默认 目录路径 = "F:\Media\" .判断结束 ' 初始化目录队列 加入成员 (目录队列, 目录路径) ' 使用队列实现递归枚举 .判断循环首 (取数组成员数 (目录队列) > 0) 当前目录 = 目录队列 [1] 删除成员 (目录队列, 1, 1) ' 弹出队列第一个元素 ' 枚举当前目录下的文件 搜索句柄 = 文件_寻找文件 (当前目录 + "*.*", ) .判断循环首 (搜索句柄 ≠ 0) 文件名 = 文件_查找文件名 (搜索句柄) ' 获取文件名 ' 过滤特殊目录 .如果真 (文件名 ≠ "." 且 文件名 ≠ "..") .局部变量 完整路径, 文本型 完整路径 = 当前目录 + 文件名 ' 检查是否为目录 .如果真 (文件_是否为目录 (完整路径)) 完整路径 = 完整路径 + "\" ' 添加路径分隔符 加入成员 (目录队列, 完整路径) ' 加入待处理队列 .否则 ' 文件处理 进入许可区 (许可证) 加入成员 (文件列表, 完整路径) 退出许可区 (许可证) .如果真结束 .如果真结束 ' 继续查找下一个 文件_查找下一个文件 (搜索句柄) .判断循环尾 () ' 关闭搜索句柄 文件_关闭搜索句柄 (搜索句柄) .判断循环尾 () ``` ### 完全兼容的解决方案说明: 1. **避免使用结构体**: - 使用`文件_查找文件名`代替结构体获取文件名 - 使用`文件_是否为目录`判断文件类型 - 这些函数在精易模块所有版本中都保持一致 2. **核心精易函数**: - `文件_寻找文件` - 开始文件搜索 - `文件_查找下一个文件` - 获取下一个文件 - `文件_关闭搜索句柄` - 释放资源 - `文件_是否为目录` - 检查路径是否为目录 3. **目录处理优化**: - 使用队列(`目录队列`)代替递归 - 自动添加路径分隔符`\` - 跳过特殊目录`.`和`..` 4. **多线程安全**: - `进入许可区`/`退出许可区`保护共享资源 - 每个线程处理独立目录树 - 等待线程完成机制确保有序退出 ### 精易模块函数说明: ```vb ' 文件_寻找文件 - 查找第一个文件 .返回值类型 整数型 .参数 路径, 文本型, , 如:"C:\*.*" ' 文件_查找下一个文件 - 继续查找 .返回值类型 逻辑型 .参数 搜索句柄, 整数型 ' 文件_查找文件名 - 获取当前文件名 .返回值类型 文本型 .参数 搜索句柄, 整数型 ' 文件_是否为目录 - 判断是否为目录 .返回值类型 逻辑型 .参数 路径, 文本型 ' 文件_关闭搜索句柄 - 释放资源 .返回值类型 逻辑型 .参数 搜索句柄, 整数型 ``` ### 使用注意事项: 1. **路径格式要求**: - 目录路径必须以`\`结尾 - 文件路径不能以`\`结尾 - 使用`+`运算符拼接路径 2. **过滤特定文件**: ```vb .局部变量 扩展名, 文本型 扩展名 = 文件_取扩展名(完整路径) .如果真 (扩展名 = ".txt" 或 扩展名 = ".log") 加入成员 (文件列表, 完整路径) .如果真结束 ``` 3. **错误处理增强**: ```vb .如果真 (搜索句柄 = -1) 输出调试文本 ("路径不存在:" + 当前目录) 到循环尾 () .如果真结束 ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值