Share via

Функция CounterInitialize

  • Статья

Регистрирует поставщик и инициализирует наборы счетчиков.

Синтаксис

ULONG WINAPI CounterInitialize(void);

Параметры

У этой функции нет параметров.

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

Возвращает ERROR_SUCCESS об успешном выполнении; в противном случае — стандартный код ошибки Win32.

Комментарии

Поставщик вызывает эту функцию. Функция включает вызовы функций PerfStartProvider и PerfSetCounterSetInfo .

Средство CTRPP создает эту встроенную функцию при указании аргумента -o . Имя функции включает строку префикса , если указан аргумент -prefix .

Если указать аргументы -MemoryRoutines или -NotificationCallback (или указать атрибут обратного вызова для элемента provider ), подпись CounterInitialize изменится на следующее:

ULONG WINAPI CounterInitialize(
    __in_opt PERFLIBREQUEST NotificationCallback,
    __in_opt PERF_MEM_ALLOC MemoryAllocationFunction,
    __in_opt PERF_MEM_FREE MemoryFreeFunction,
    __inout_opt PVOID MemoryFunctionContext
);

где

NotificationCallback

Имя функции обратного вызова ControlCallback , реализуемой для получения уведомлений о запросах потребителей (например, запросов на добавление или удаление счетчиков из запроса). Если функция обратного вызова ControlCallback не реализована, задайте значение NULL.

MemoryAllocationFunction

Имя функции обратного вызова AllocateMemory , которую PERFLIB вызывает для выделения памяти. Задайте значение NULL , если аргумент -MemoryRoutines не указан.

MemoryFreeFunction

Имя функции обратного вызова FreeMemory , которую PERFLIB вызывает для освобождения памяти, выделенной с помощью функции AllocateMemory . Установите значение NULL , если memoryAllocationFunction имеет значение NULL.

MemoryFunctionContext

Контекстная информация, передаваемая в выделение памяти и бесплатные подпрограммы. Может иметь значение NULL.

Требования

Требование Значение
Минимальная версия клиента
 Windows 7 [только классические приложения]
Минимальная версия сервера
 Windows Server 2008 R2 [только классические приложения]