检索“时钟周期”(或 100 纳秒间隔)中的系统计时信息。
语法
BOOL GetSystemTimes(
[out, optional] PFILETIME lpIdleTime,
[out, optional] PFILETIME lpKernelTime,
[out, optional] PFILETIME lpUserTime
);
参数
[out, optional] lpIdleTime
指向 FILETIME 结构的指针,该结构接收系统处于空闲状态的“时钟周期”中的时间量。
[out, optional] lpKernelTime
指向 FILETIME 结构的指针,该结构接收系统在内核模式下执行所用的时间量(包括所有进程中的所有线程,在所有处理器上)。 此时间值还包括系统空闲的时间量。
[out, optional] lpUserTime
指向 FILETIME 结构的指针,该结构接收系统在用户模式下执行所用的时间量(包括所有进程中的所有线程,在所有处理器上)。
返回值
如果函数成功,则返回值为非零。
如果函数失败,则返回值为零。 若要获取扩展的错误信息,请调用 GetLastError。
注解
在多处理器系统上(处理器数为 64 个或更少),返回的值是所有处理器中指定时间的总和。
注释
在处理器数超过 64 的系统上,返回的值是调用线程所属的主处理器组指定时间之和(请参阅 处理器组)。
若要编译使用此函数的应用程序,请将_WIN32_WINNT定义为0x0501或更高版本。 有关详细信息,请参阅 使用 Windows 标头。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 具有 SP1 的 Windows Vista、Windows XP [仅限桌面应用] |
| 支持的最低服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows操作系统 |
| 标头 | processthreadsapi.h (包括 Windows.h) |
| 图书馆 | 内核 32.lib |
| DLL | Kernel32.dll |