PdhCalculateCounterFromRawValue 関数 (pdh.h)

  • [アーティクル]

2 つの生カウンター値の表示可能な値を計算します。

構文

PDH_FUNCTION PdhCalculateCounterFromRawValue(
  [in]  PDH_HCOUNTER          hCounter,
  [in]  DWORD                 dwFormat,
  [in]  PPDH_RAW_COUNTER      rawValue1,
  [in]  PPDH_RAW_COUNTER      rawValue2,
  [out] PPDH_FMT_COUNTERVALUE fmtValue
);

パラメーター

[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] rawValue1

表示可能なカウンター値を計算するために使用される生のカウンター値。 詳細については、PDH_RAW_COUNTER構造に 関するページを 参照してください。

[in] rawValue2

表示可能なカウンター値を計算するために使用される生のカウンター値。 詳細については、「 PDH_RAW_COUNTER」を参照してください。 一部のカウンター (レート カウンターなど) では、表示可能な値を計算するために 2 つの生の値が必要です。 カウンター型に 2 番目の値が必要ない場合は、このパラメーターを NULL に設定 します。 この値は、2 つの生の値の古い値である必要があります。

[out] fmtValue

計算されたカウンター値を受け取る PDH_FMT_COUNTERVALUE 構造体。

戻り値

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

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

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

注釈

クエリから現在の生カウンター値を取得するには、 PdhGetRawCounterValue 関数を呼び出します。

要件

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

こちらもご覧ください

PDH_FMT_COUNTERVALUE

PDH_RAW_COUNTER

PdhGetFormattedCounterValue

PdhGetRawCounterValue

PdhSetCounterScaleFactor