GetThreadTimes

指定したスレッドのタイミング情報を取得する。

GetThreadTimes hThread, lpCreationTime, lpExitTime, lpKernelTime, lpUserTime

hThread : [intptr] タイミング情報を取得したいスレッドのハンドル。ハンドルは THREAD_QUERY_INFORMATION または THREAD_QUERY_LIMITED_INFORMATION アクセス権を持つ必要がある。詳細は Thread Security and Access Rights を参照。Windows Server 2003 および Windows XP: ハンドルは THREAD_QUERY_INFORMATION アクセス権を持つ必要がある。
lpCreationTime : [var] スレッドの作成時刻を受け取る FILETIME 構造体へのポインタ。
lpExitTime : [var] スレッドの終了時刻を受け取る FILETIME 構造体へのポインタ。スレッドが終了していない場合、この構造体の内容は未定義である。
lpKernelTime : [var] スレッドがカーネルモードで実行された時間を受け取る FILETIME 構造体へのポインタ。
lpUserTime : [var] スレッドがユーザーモードで実行された時間を受け取る FILETIME 構造体へのポインタ。

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

解説

指定したスレッドのタイミング情報を取得する。

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

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

情報