GetProcessTimes

指定したプロセスのタイミング情報を取得する。

GetProcessTimes hProcess, lpCreationTime, lpExitTime, lpKernelTime, lpUserTime

hProcess : [intptr] タイミング情報を取得したいプロセスのハンドル。ハンドルは PROCESS_QUERY_INFORMATION または PROCESS_QUERY_LIMITED_INFORMATION アクセス権を持つ必要がある。詳細は Process Security and Access Rights を参照。Windows Server 2003 および Windows XP: ハンドルは PROCESS_QUERY_INFORMATION アクセス権を持つ必要がある。
lpCreationTime : [var] プロセスの作成時刻を受け取る FILETIME 構造体へのポインタ。
lpExitTime : [var] プロセスの終了時刻を受け取る FILETIME 構造体へのポインタ。プロセスが終了していない場合、この構造体の内容は未定義である。
lpKernelTime : [var] プロセスがカーネルモードで実行された時間を受け取る FILETIME 構造体へのポインタ。プロセスの各スレッドがカーネルモードで実行された時間が決定され、それらの時間がすべて合計されてこの値が得られる。
lpUserTime : [var] プロセスがユーザーモードで実行された時間を受け取る FILETIME 構造体へのポインタ。プロセスの各スレッドがユーザーモードで実行された時間が決定され、それらの時間がすべて合計されてこの値が得られる。プロセスが複数の CPU コアにまたがって実行される場合、この値は経過した実時間（lpCreationTime と lpExitTime の間）を超えうることに注意。

(プラグイン / モジュール : kernel32.dll)

解説

指定したプロセスのタイミング情報を取得する。

[戻り値]
関数が成功した場合、戻り値は 0 以外。関数が失敗した場合、戻り値は 0。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
すべての時刻は FILETIME データ構造体を使用して表される。このような構造体は、結合して 100 ナノ秒時間単位の 64
ビットカウントを形成する 2 つの 32 ビット値を含む。プロセスの作成および終了時刻は、1601 年 1 月 1 日午前 0
時（イギリス、グリニッジ）から経過した時間として表現された時点である。アプリケーションがこのような値をより一般的に有用な形式に変換するために使用できる関数がいくつかある。プロセスのカーネルモードおよびユーザーモード時間は時間量である。たとえば、プロセスがカーネルモードで
1 秒を費やした場合、この関数は lpKernelTime で指定された FILETIME 構造体を 64 ビット値の 1000
万で埋める。これは 1 秒間の 100 ナノ秒単位の数である。プロセスのスレッドが使用した CPU
クロックサイクル数を取得するには、QueryProcessCycleTime 関数を使用する。

情報