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

Функция FormatFromRawValue

Преобразует одно значение необработанных данных о производительности в указанный формат или делает это для двух значений, если преобразование формата зависит от времени.

Примечание

Этот интерфейс API предназначен только для внутреннего использования. Он не предназначен для использования из кода разработчика.

Синтаксис

int FormatFromRawValue (
   [in] uint                    dwCounterType,
   [in] uint                    dwFormat,
   [in] long*                   pTimeBase,
   [in] PDH_RAW_COUNTER*        pRawValue1,
   [in] PDH_RAW_COUNTER*        pRawValue2,
   [out] PDH_FMT_COUNTERVALUE*  pFmtValue
);

Параметры

dwCounterType
[in] Тип счетчика. Список типов счетчиков см. в разделе Типы счетчиков производительности WMI. dwCounterType Может быть любым типом счетчика, PERF_LARGE_RAW_FRACTION кроме и PERF_LARGE_RAW_BASE.

dwFormat
[in] Формат, в который преобразуются необработанные данные о производительности. Может иметь одно из следующих значений.

Константа Значение Описание
PDH_FMT_DOUBLE 0x00000200 Возвращает вычисляемое значение в виде значения двойной точности с плавающей запятой.
PDH_FMT_LARGE 0x00000400 Возвращает вычисляемое значение в виде 64-разрядного целого числа.
PDH_FMT_LONG 0x00000100 Возвращает вычисляемое значение в виде 32-разрядного целого числа.

Одно из предыдущих значений может быть ORed с одним из следующих флагов масштабирования:

Константа Значение Описание
PDH_FMT_NOSCALE 0x00001000 Не применяйте коэффициенты масштабирования счетчика.
PDH_FMT_1000 0x00002000 Умножьте конечное значение на 1000.

pTimeBase
[in] Указатель на базу времени, если это необходимо для преобразования формата. Если для преобразования формата не требуется информация о временной базе, значение этого параметра игнорируется.

pRawValue1
[in] Указатель на структуру PDH_RAW_COUNTER , представляющую необработанное значение производительности.

pRawValue2
[in] Указатель на структуру PDH_RAW_COUNTER , представляющую второе необработанное значение производительности. Если второе необработанное значение производительности не требуется, этот параметр должен иметь значение null.

pFmtValue
[out] Указатель на структуру PDH_FMT_COUNTERVALUE , которая получает отформатированное значение производительности.

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

Эта функция возвращает следующие значения:

Константа Значение Описание
ERROR_SUCCESS 0 Вызов функции выполнен успешно.
PDH_INVALID_ARGUMENT 0xC0000BBD Обязательный аргумент отсутствует или неправильный.
PDH_INVALID_HANDLE 0xC0000BBC Дескриптор не является допустимым объектом PDH.

Комментарии

Эта функция заключает в оболочку вызов функции FormatFromRawValue .

Требования

Платформы: см. раздел Требования к системе.

Библиотека: PerfCounter.dll

версии платформа .NET Framework: доступно с версии 4.7.2.

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

  • Last updated on