EnableThreadProfiling

指定したスレッドでスレッドプロファイリングを有効にする。

EnableThreadProfiling ThreadHandle, Flags, HardwareCounters, PerformanceDataHandle

ThreadHandle : [intptr] プロファイリングを有効にするスレッドへのハンドル。これは現在のスレッドでなければならない。
Flags : [int] コンテキストスイッチカウントなどのスレッドプロファイリングデータを受け取るには、このパラメータを THREAD_PROFILING_FLAG_DISPATCH に設定する。それ以外の場合は 0 に設定する。
HardwareCounters : [int64] ハードウェアパフォーマンスカウンタデータを受け取るには、このパラメータに収集するハードウェアカウンタを識別するビットマスクを設定する。最大 16 個のパフォーマンスカウンタを指定できる。各ビットは、構成済みのハードウェアパフォーマンスカウンタの 0 ベースのハードウェアカウンタインデックスに直接対応する。ハードウェアカウンタデータを収集していない場合は 0 に設定する。構成されていないハードウェアカウンタのビットを設定した場合、そのカウンタについて読み取られるカウンタ値は 0 となる。
PerformanceDataHandle : [intptr] ReadThreadProfilingData および DisableThreadProfiling 関数を呼ぶ際に使用する不透明なハンドル。

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

解説

指定したスレッドでスレッドプロファイリングを有効にする。

[戻り値]
呼び出しが成功した場合 ERROR_SUCCESS を返す。それ以外の場合、システムエラーコード（Winerror.h を参照）を返す。

[備考]
スレッドを終了する前に DisableThreadProfiling
関数を呼ばなければならない。ハードウェアパフォーマンスカウンタをプロファイリングするには、カウンタを構成するドライバが必要である。パフォーマンスカウンタはシステム全体でグローバルに構成されているため、すべてのスレッドが同じハードウェアカウンタデータにアクセスできる。プロファイリングを有効にする前にカウンタを構成しなければならない。ハードウェアパフォーマンスカウンタの構成については
Windows Driver Kit (WDK) の KeSetHardwareCounterConfiguration 関数を参照。

情報