EnableThreadProfiling 関数 (winbase.h)
指定したスレッドでスレッド プロファイルを有効にします。
構文
DWORD EnableThreadProfiling(
[in] HANDLE ThreadHandle,
[in] DWORD Flags,
[in] DWORD64 HardwareCounters,
[out] HANDLE *PerformanceDataHandle
);
パラメーター
[in] ThreadHandle
プロファイリングを有効にするスレッドのハンドル。 これは現在のスレッドである必要があります。
[in] Flags
コンテキスト 切り替え数などのスレッド プロファイル データを受信するには、このパラメーターを THREAD_PROFILING_FLAG_DISPATCH に設定します。それ以外の場合は、0 に設定します。
[in] HardwareCounters
ハードウェア パフォーマンス カウンター データを受信するには、このパラメーターを、収集するハードウェア カウンターを識別するビットマスクに設定します。 最大 16 個のパフォーマンス カウンターを指定できます。 各ビットは、構成したハードウェア パフォーマンス カウンターの 0 から始まるハードウェア カウンター インデックスに直接関連付けられます。 ハードウェア カウンター データを収集していない場合は、0 に設定します。 構成されていないハードウェア カウンターにビットを設定した場合、そのカウンターに対して読み取られたカウンター値は 0 になります。
[out] PerformanceDataHandle
ReadThreadProfilingData 関数と DisableThreadProfiling 関数を呼び出すときに使用する不透明なハンドル。
戻り値
呼び出しが成功した場合は、ERROR_SUCCESSを返します。それ以外の場合は、システム エラー コード (Winerror.h を参照)。
注釈
スレッドを終了する前に DisableThreadProfiling 関数を呼び出す必要があります。
ハードウェア パフォーマンス カウンターをプロファイリングするには、カウンターを構成するためのドライバーが必要です。 パフォーマンス カウンターはシステム用にグローバルに構成されるため、すべてのスレッドが同じハードウェア カウンター データにアクセスできます。 プロファイリングを有効にする前に、カウンターを構成する必要があります。 ハードウェア パフォーマンス カウンターの構成については、Windows ドライバー キット (WDK) の KeSetHardwareCounterConfiguration 関数を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winbase.h (Windows.h を含む) |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |