设置在请求格式化计数器值时应用于指定计数器的计算值的比例因子。 如果设置了PDH_FMT_NOSCALE标志,则忽略此比例系数。
语法
PDH_FUNCTION PdhSetCounterScaleFactor(
[in] PDH_HCOUNTER hCounter,
[in] LONG lFactor
);
参数
[in] hCounter
要对其应用比例因子的计数器的句柄。 PdhAddCounter 函数返回此句柄。
[in] lFactor
十的幂,在返回计算值之前乘以计算值。 此参数的最小值为 PDH_MIN_SCALE (–7) ,其中返回的值是实际值乘以 10-⁷。 此参数的最大值为 PDH_MAX_SCALE (+7) ,其中返回的值是实际值乘以 10⁺⁷。 如果值为零,则将刻度设置为 1,以便返回实际值。
返回值
如果函数成功,则返回ERROR_SUCCESS。
如果函数失败,则返回值为 系统错误代码 或 PDH 错误代码。 下面是可能的值。
| 返回代码 | 说明 |
|---|---|
|
刻度值在范围外。 |
|
计数器句柄无效。 |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | pdh.h |
| Library | Pdh.lib |
| DLL | Pdh.dll |