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 エラー コードです。 使用できる値を次に示します。
リターン コード | 説明 |
---|---|
|
スケール値が範囲外です。 |
|
カウンター ハンドルが無効です。 |
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | pdh.h |
Library | Pdh.lib |
[DLL] | Pdh.dll |