通过

PdhComputeCounterStatistics 函数 (pdh.h)

  • 项目

从原始值数组中计算计数器的统计信息。

语法

PDH_FUNCTION PdhComputeCounterStatistics(
  [in]  PDH_HCOUNTER     hCounter,
  [in]  DWORD            dwFormat,
  [in]  DWORD            dwFirstEntry,
  [in]  DWORD            dwNumEntries,
  [in]  PPDH_RAW_COUNTER lpRawValueArray,
  [out] PPDH_STATISTICS  data
);

参数

[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] dwFirstEntry

用于开始计算的第一个原始计数器值的从零开始的索引。 索引值必须指向缓冲区中最早的条目。 函数从此条目开始扫描缓冲区，在最后一个条目处包装回缓冲区的开头，并一直环绕到 dwFirstEntry-1 条目，假定为最新或最新数据。

[in] dwNumEntries

lpRawValueArray 缓冲区中的原始计数器值数。

[in] lpRawValueArray

包含 dwNumEntries 条目的PDH_RAW_COUNTER结构的数组。

[out] data

接收计数器统计信息 的PDH_STATISTICS 结构。

返回值

如果函数成功，则返回ERROR_SUCCESS。

如果函数失败，则返回值为 系统错误代码 或 PDH 错误代码。 下面是可能的值。

返回代码 说明
PDH_INVALID_ARGUMENT
 参数不正确或格式不正确。
PDH_INVALID_HANDLE
 计数器句柄无效。

要求

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

另请参阅

PDH_RAW_COUNTER

PDH_STATISTICS

PdhCalculateCounterFromRawValue

PdhGetRawCounterValue

PdhSetCounterScaleFactor