PdhGetCounterTimeBase 函数 (pdh.h)

返回指定计数器的时基。

语法

PDH_FUNCTION PdhGetCounterTimeBase(
  [in]  PDH_HCOUNTER hCounter,
  [out] LONGLONG     *pTimeBase
);

parameters

[in] hCounter

计数器的句柄。 PdhAddCounter 函数返回此句柄。

[out] pTimeBase

指定每秒计数器采样的性能值数的基准时间。

返回值

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

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

返回代码 说明
PDH_INVALID_ARGUMENT
指定的计数器不使用时基。
PDH_INVALID_HANDLE
计数器句柄无效。

注解

如果使用 PdhFormatFromRawValue 函数来计算可显示的值,而不是调用 PdhCalculateCounterFromRawValue 函数,则必须调用 PdhGetCounterTimeBase 函数来检索时基。

每个返回基于时间的性能数据的计数器都为其定义了一个时基。 计数器的时基数是计数器每秒对数据进行采样的次数。

要求

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

请参阅

PdhFormatFromRawValue