PdhSetCounterScaleFactor 関数 (pdh.h)

  • [アーティクル]

書式設定されたカウンター値を要求するときに、指定したカウンターの計算値に適用されるスケール ファクターを設定します。 PDH_FMT_NOSCALE フラグが設定されている場合、このスケール ファクターは無視されます。

構文

PDH_FUNCTION PdhSetCounterScaleFactor(
  [in] PDH_HCOUNTER hCounter,
  [in] LONG         lFactor
);

パラメーター

[in] hCounter

スケール ファクターを適用するカウンターのハンドル。 PdhAddCounter 関数は、このハンドルを返します。

[in] lFactor

計算された値を返す前に乗算する 10 の累乗。 このパラメーターの最小値は PDH_MIN_SCALE (–7) です。ここで、戻り値は実際の値に 10 – ⁷ を掛けた値です。 このパラメーターの最大値はPDH_MAX_SCALE (+7) です。ここで、戻り値は実際の値に 10⁺⁷ を掛けた値です。 値 0 を指定すると、スケールが 1 に設定され、実際の値が返されます。

戻り値

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

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

リターン コード 説明
PDH_INVALID_ARGUMENT
 スケール値が範囲外です。
PDH_INVALID_HANDLE
 カウンター ハンドルが無効です。

要件

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

こちらもご覧ください

PdhCalculateCounterFromRawValue

PdhComputeCounterStatistics

PdhGetFormattedCounterValue