PdhGetCounterTimeBase 関数 (pdh.h)

指定したカウンターの時間ベースを返します。

構文

PDH_FUNCTION PdhGetCounterTimeBase(
  [in]  PDH_HCOUNTER hCounter,
  [out] LONGLONG     *pTimeBase
);

[in] hCounter

カウンターへのハンドル。 PdhAddCounter 関数は、このハンドルを返します。

[out] pTimeBase

1 秒あたりのカウンターサンプルのパフォーマンス値の数を指定する時間ベース。

関数が成功すると、ERROR_SUCCESSが返されます。

関数が失敗した場合、戻り値はシステムエラーコードまたは PDH エラーコードです。使用できる値を次に示します。

リターンコード	説明
PDH_INVALID_ARGUMENT	指定したカウンターでは、時間ベースは使用されません。
PDH_INVALID_HANDLE	カウンターハンドルが無効です。

PdhFormatFromRawValue 関数を使用して PdhCalculateCounterFromRawValue 関数を呼び出す代わりに表示可能な値を計算する場合は、PdhGetCounterTimeBase 関数を呼び出して時間ベースを取得する必要があります。

時間ベースのパフォーマンスデータを返す各カウンターには、時間ベースが定義されています。カウンターの時間ベースは、カウンターが 1 秒あたりのデータをサンプリングする回数です。