Share via

GetSystemTimes 関数 (processthreadsapi.h)

  • [アーティクル]

システムのタイミング情報を取得します。 マルチプロセッサ システムでは、返される値は、すべてのプロセッサで指定された時間の合計です。

構文

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 構造体へのポインター。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNTを 0x0501 以降として定義します。 詳細については、「 Windows ヘッダーの使用」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows Vista、WINDOWS XP と SP1 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー processthreadsapi.h (Windows.h を含む)
Library Kernel32.lib
[DLL] Kernel32.dll

関連項目

FILETIME

システム時刻

時間関数