PdhComputeCounterStatistics 関数 (pdh.h)

  • [アーティクル]

生の値の配列からカウンターの統計を計算します。

構文

PDH_FUNCTION PdhComputeCounterStatistics(
  [in]  PDH_HCOUNTER     hCounter,
  [in]  DWORD            dwFormat,
  [in]  DWORD            dwFirstEntry,
  [in]  DWORD            dwNumEntries,
  [in]  PPDH_RAW_COUNTER lpRawValueArray,
  [out] PPDH_STATISTICS  data
);

パラメーター

[in] hCounter

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

[in] dwFormat

書式設定された値のデータ型を決定します。 次のいずれかの値を指定します。

値 意味
PDH_FMT_DOUBLE
 計算された値を倍精度浮動小数点実数として返します。
PDH_FMT_LARGE
 計算された値を 64 ビット整数として返します。
PDH_FMT_LONG
 計算された値を長整数として返します。
 

ビットごとの包括 OR 演算子 (|) を使用して、データ型を次のいずれかのスケーリング 要因と組み合わせることができます。

値 意味
PDH_FMT_NOSCALE
 カウンターのスケーリング 係数を計算に適用しないでください。
PDH_FMT_NOCAP100
 100 を超えるカウンター値 (たとえば、マルチプロセッサ コンピューターのプロセッサ負荷を測定するカウンター値) は 100 にリセットされません。 既定の動作では、カウンター値の上限は 100 です。
PDH_FMT_1000
 最終的な値を 1,000 で乗算します。

[in] dwFirstEntry

計算を開始するために使用する最初の生カウンター値の 0 から始まるインデックス。 インデックス値は、バッファー内の最も古いエントリを指している必要があります。 関数は、このエントリから開始し、バッファーをスキャンし、最後のエントリをバッファーの先頭に戻し、 dwFirstEntry-1 エントリまでラップします。これは、最新または最新のデータと見なされます。

[in] dwNumEntries

lpRawValueArray バッファー内の生カウンター値の数。

[in] lpRawValueArray

dwNumEntries エントリを含むPDH_RAW_COUNTER構造体の配列。

[out] data

カウンター統計を受け取る PDH_STATISTICS 構造体。

戻り値

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

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

リターン コード 説明
PDH_INVALID_ARGUMENT
 引数が正しくないか、正しく書式設定されていません。
PDH_INVALID_HANDLE
 カウンター ハンドルが無効です。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー pdh.h
Library Pdh.lib
[DLL] Pdh.dll

こちらもご覧ください

PDH_RAW_COUNTER

PDH_STATISTICS

PdhCalculateCounterFromRawValue

PdhGetRawCounterValue

PdhSetCounterScaleFactor