GetSystemTimes 函数 (processthreadsapi.h)

检索“时钟周期”(或 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