CloseTimer function
关闭一个由 NewTimer function 所创建的计时器
Function:
bool UAPI CloseTimer(
int hTimer,
bool bForce
);
Parameters:
- hTimer [in]:计时器句柄
- bForce [in]:强制关闭
Notes:应避免此参数为 TRUE,否则会造成内存泄漏
Return value:
- Type:BOOL
- Text:成功返回 TRUE,失败返回 FALSE
Remarks:
- CloseTimer function 通过 Wisend function 实现通知计时器主线程安全退出,但该行为在参数 bForce 为 TRUE 时不可用
- 除非必要,否则开发者应保证参数 bForce 是 FALSE,否则会造成全局内存泄漏和内核对象泄漏
- 开发者应尽可能让计时器的任务周期处于可控范围,CloseTimer function 在使用 Wisend function 通知其计时器主线程退出后该通知会在其计时器任务下次被唤醒时被检查。所以较长的计时器周期会导致 CloseTimer function 的阻塞时间变长
- 开发者可以在计时器任务处理例程函数中返回 INVALID 来主动安全退出计时器
Requirements:
| Keyword | Value |
|---|---|
| Minimum Agine Version | 171012.1 |
| Minimum SDK Version | 171012.1 |
| Header File | h.thread |
| Library Server | kext |