pdhSetCounterScaleFactor 函数 (pdh.h)

设置在请求格式化计数器值时应用于指定计数器的计算值的比例因子。 如果设置了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 错误代码。 下面是可能的值。

返回代码 说明
PDH_INVALID_ARGUMENT
刻度值在范围外。
PDH_INVALID_HANDLE
计数器句柄无效。

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 pdh.h
Library Pdh.lib
DLL Pdh.dll

另请参阅

PdhCalculateCounterFromRawValue

PdhComputeCounterStatistics

PdhGetFormattedCounterValue