Функция PerfSetULongLongCounterValue (perflib.h)
Обновления значение счетчика со значением 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