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

Статья
03/05/2024

Задает коэффициент масштабирования, применяемый к вычисляемой величине указанного счетчика при запросе отформатированного значения счетчика. Если установлен флаг 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
Header	pdh.h
Библиотека	Pdh.lib
DLL	Pdh.dll

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

PdhCalculateCounterFromRawValue

PdhComputeCounterStatistics

PdhGetFormattedCounterValue

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