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


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

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

Синтаксис

ULONG PerfIncrementULongLongCounterValue(
  [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

Значение, на которое увеличивается счетчик.

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

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

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

Комментарии

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

Используйте функцию PerfSetULongLongCounterValue для первоначального задания значения счетчика.

Обратите внимание, что значение счетчика будет переполнено, когда значение счетчика увеличивается до максимального размера 8-байтового целого числа без знака.

Требования

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

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

PerfDecrementULongLongCounterValue

PerfIncrementULongCounterValue

PerfSetULongLongCounterValue