pdhCalculateCounterFromRawValue 函数 (pdh.h)

  • 项目

计算两个原始计数器值的可显示值。

语法

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
 将最终值乘以 1000。

[in] rawValue1

用于计算可显示的计数器值的原始计数器值。 有关详细信息，请参阅 PDH_RAW_COUNTER 结构。

[in] rawValue2

用于计算可显示的计数器值的原始计数器值。 有关详细信息，请参阅 PDH_RAW_COUNTER。 例如，某些计数器 (速率计数器) 需要两个原始值来计算可显示的值。 如果计数器类型不需要第二个值，请将此参数设置为 NULL。 此值必须是两个原始值中的较早值。

[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