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

Статья
08/25/2023

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

Синтаксис

PDH_FUNCTION PdhFormatFromRawValue(
  [in]  DWORD                 dwCounterType,
  [in]  DWORD                 dwFormat,
  [in]  LONGLONG              *pTimeBase,
  [in]  PPDH_RAW_COUNTER      pRawValue1,
  [in]  PPDH_RAW_COUNTER      pRawValue2,
  [out] PPDH_FMT_COUNTERVALUE pFmtValue
);

Параметры

[in] dwCounterType

Тип счетчика. Как правило, pdhGetCounterInfo вызывается для получения типа счетчика при вызове PdhGetRawCounterValue для получения необработанного значения счетчика.

Список типов счетчиков см. в разделе Типы счетчиков комплекта развертывания Windows Server 2003. (Значения констант определяются в Winperf.h.)

Обратите внимание, что вы не можете указать базовые типы, например PERF_LARGE_RAW_BASE.

[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] pTimeBase

Указатель на базу времени, если это необходимо для преобразования формата. Если для преобразования формата не требуется базовая информация о времени, значение этого параметра игнорируется. Чтобы получить базу времени счетчика, вызовите PdhGetCounterTimeBase.

[in] pRawValue1

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

[in] pRawValue2

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

[out] pFmtValue

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

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

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

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

Требования

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

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

PDH_FMT_COUNTERVALUE

PDH_RAW_COUNTER

PdhGetCounterInfo

PdhGetCounterTimeBase

PdhGetRawCounterValue

PdhReadRawLogRecord

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