指定したカウンターの時間ベースを返します。
構文
PDH_FUNCTION PdhGetCounterTimeBase(
[in] PDH_HCOUNTER hCounter,
[out] LONGLONG *pTimeBase
);
パラメーター
[in] hCounter
カウンターへのハンドル。 PdhAddCounter 関数は、このハンドルを返します。
[out] pTimeBase
1 秒あたりのカウンター サンプルのパフォーマンス値の数を指定する時間ベース。
戻り値
関数が成功すると、ERROR_SUCCESSが返されます。
関数が失敗した場合、戻り値は システム エラー コード または PDH エラー コードです。 使用できる値を次に示します。
| リターン コード | 説明 |
|---|---|
|
指定したカウンターでは、時間ベースは使用されません。 |
|
カウンター ハンドルが無効です。 |
解説
PdhFormatFromRawValue 関数を使用して PdhCalculateCounterFromRawValue 関数を呼び出す代わりに表示可能な値を計算する場合は、PdhGetCounterTimeBase 関数を呼び出して時間ベースを取得する必要があります。
時間ベースのパフォーマンス データを返す各カウンターには、時間ベースが定義されています。 カウンターの時間ベースは、カウンターが 1 秒あたりのデータをサンプリングする回数です。
要件
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | pdh.h |
| Library | Pdh.lib |
| [DLL] | Pdh.dll |