Функция PerfSetULongLongCounterValue (perflib.h)

Статья
08/25/2023

Обновления значение счетчика со значением 8-байтового целого числа без знака. Поставщики используют эту функцию.

Синтаксис

ULONG PerfSetULongLongCounterValue(
  [in] HANDLE                    Provider,
  [in] PPERF_COUNTERSET_INSTANCE Instance,
  [in] ULONG                     CounterId,
  [in] ULONGLONG                 Value
);

Параметры

[in] Provider

Дескриптор поставщика. Используйте переменную дескриптора, созданную инструментом CTRPP . Имя переменной см. в атрибуте символа элемента provider .

Windows Vista: Функция PerfStartProvider возвращает дескриптор.

[in] Instance

Структура PERF_COUNTERSET_INSTANCE , содержащая экземпляр набора счетчиков. Функция PerfCreateInstance возвращает этот указатель.

[in] CounterId

Идентификатор, однозначно определяющий счетчик для обновления в блоке экземпляра. Идентификатор определяется в атрибуте id элемента counter и должен соответствовать элементу CounterId одной из PERF_COUNTER_INFO структур в блоке экземпляра. Используйте константу идентификатора счетчика, созданную средством CTRPP . Имя константы см. в атрибуте символа элемента счетчика .

Windows Vista: Константы идентификатора счетчика недоступны.

[in] Value

Новое 8-байтовое значение счетчика.

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

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

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

Это удобная функция для настройки необработанных данных счетчика. Чтобы самостоятельно обновить необработанные данные счетчика, используйте элемент Offset структуры PERF_COUNTER_INFO для доступа к необработанным данным счетчика для определенного счетчика. Блок структуры PERF_COUNTERSET_INSTANCE содержит одну или несколько информационных структур счетчиков.

Для увеличения или уменьшения значения счетчика можно использовать функции PerfIncrementULongLongCounterValue и PerfDecrementULongCounterValue соответственно.

Требования

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

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

PerfDecrementULongLongCounterValue

PerfIncrementULongLongCounterValue

PerfSetCounterRefValue

PerfSetULongCounterValue

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