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

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

  • Статья

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

Синтаксис

PDH_FUNCTION PdhCalculateCounterFromRawValue(
  [in]  PDH_HCOUNTER          hCounter,
  [in]  DWORD                 dwFormat,
  [in]  PPDH_RAW_COUNTER      rawValue1,
  [in]  PPDH_RAW_COUNTER      rawValue2,
  [out] PPDH_FMT_COUNTERVALUE fmtValue
);

Параметры

[in] hCounter

Дескриптор для вычисления счетчика. Функция использует сведения из счетчика для определения способа вычисления значения. Этот дескриптор возвращается функцией PdhAddCounter .

[in] dwFormat

Определяет тип данных вычисляемого значения. Укажите одно из следующих значений.

Значение Значение
PDH_FMT_DOUBLE
 Возвращает вычисляемое значение как вещественное значение двойной точности с плавающей запятой.
PDH_FMT_LARGE
 Возвращает вычисляемое значение в виде 64-разрядного целого числа.
PDH_FMT_LONG
 Возвращает вычисляемое значение в виде длинного целого числа.
 

Для объединения типа данных с одним из следующих факторов масштабирования можно использовать побитовый оператор ИЛИ (|).

Значение Значение
PDH_FMT_NOSCALE
 Не применяйте коэффициент масштабирования счетчика в вычислении.
PDH_FMT_NOCAP100
 Значения счетчиков, превышающие 100 (например, значения счетчика, измеряющего нагрузку процессора на многопроцессорных компьютерах), не будут сброшены до 100. По умолчанию значения счетчиков ограничены значением 100.
PDH_FMT_1000
 Умножьте конечное значение на 1000.

[in] rawValue1

Необработанное значение счетчика, используемое для вычисления отображаемого значения счетчика. Дополнительные сведения см . в PDH_RAW_COUNTER структуре.

[in] rawValue2

Необработанное значение счетчика, используемое для вычисления отображаемого значения счетчика. Дополнительные сведения см. в разделе PDH_RAW_COUNTER. Для некоторых счетчиков (например, счетчиков скорости) требуется два необработанных значения для вычисления отображаемого значения. Если тип счетчика не требует второго значения, задайте для этого параметра значение NULL. Это значение должно быть более старым из двух необработанных значений.

[out] fmtValue

Структура PDH_FMT_COUNTERVALUE , получающая вычисляемое значение счетчика.

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

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

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

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

Комментарии

Чтобы получить текущее необработанное значение счетчика из запроса, вызовите функцию PdhGetRawCounterValue .

Требования

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

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

PDH_FMT_COUNTERVALUE

PDH_RAW_COUNTER

PdhGetFormattedCounterValue

PdhGetRawCounterValue

PdhSetCounterScaleFactor