Поделиться через

Функция PdhGetCounterTimeBase (pdh.h)

  • Статья

Возвращает базу времени указанного счетчика.

Синтаксис

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

Параметры

[in] hCounter

Дескриптор для счетчика. Функция PdhAddCounter возвращает этот дескриптор.

[out] pTimeBase

База времени, указывающая количество значений производительности, выборок счетчика в секунду.

Возвращаемое значение

Если функция завершается успешно, она возвращает ERROR_SUCCESS.

Если функция завершается сбоем, возвращаемое значение представляет собой код системной ошибки или код ошибки PDH. Ниже приведены возможные значения.

Код возврата Описание
PDH_INVALID_ARGUMENT
 Указанный счетчик не использует базу времени.
PDH_INVALID_HANDLE
 Недопустимый дескриптор счетчика.

Комментарии

При использовании функции PdhFormatFromRawValue для вычисления отображаемого значения вместо вызова функции PdhCalculateCounterFromRawValue необходимо вызвать функцию PdhGetCounterTimeBase , чтобы получить базу времени.

Каждый счетчик, возвращающий данные о производительности на основе времени, имеет определенную базу времени. База времени счетчика — это количество выборок данных счетчика в секунду.

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header pdh.h
Библиотека Pdh.lib
DLL Pdh.dll

См. также раздел

PdhFormatFromRawValue