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

Статья
08/25/2023

Вычисляет статистику для счетчика из массива необработанных значений.

Синтаксис

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

Массив PDH_RAW_COUNTER структур, содержащих записи dwNumEntries .

[out] data

Структура PDH_STATISTICS , получающая статистику счетчика.

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

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

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

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

Требования

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

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

PDH_RAW_COUNTER

PDH_STATISTICS

PdhCalculateCounterFromRawValue

PdhGetRawCounterValue

PdhSetCounterScaleFactor

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