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 個處理器或更少處理器） 上，傳回的值是所有處理器中指定時間的總和，以「刻度」為單位。

若要編譯使用此函式的應用程式，請將_WIN32_WINNT定義為0x0501或更新版本。 如需詳細資訊，請參閱使用 Windows 標頭 。

需求