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


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

Регистрирует поставщика.

Синтаксис

ULONG PerfStartProviderEx(
  [in]           LPGUID                 ProviderGuid,
  [in, optional] PPERF_PROVIDER_CONTEXT ProviderContext,
  [out]          PHANDLE                Provider
);

Параметры

[in] ProviderGuid

GUID, который однозначно идентифицирует поставщика. Атрибут providerGuid элемента provider указывает GUID.

[in, optional] ProviderContext

Структура PERF_PROVIDER_CONTEXT , содержащая указатели на обратный вызов элемента управления, подпрограммы управления памятью и сведения о контексте.

[out] Provider

Дескриптор для поставщика. Чтобы освободить ресурсы, связанные с дескриптором, необходимо вызвать PerfStopProvider .

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

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

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

Комментарии

Функция CounterInitialize вызывает эту функцию; не вызывайте эту функцию напрямую.

Windows Vista: Функция PerfAutoInitialize вызывает эту функцию.

Средство CTRPP включает эту функцию вместо PerfStartProvider, если при вызове CTRPP используется аргумент -MemoryRoutines или аргумент -NotificationCallback или атрибут обратного вызова элемента поставщика имеет значение custom.

Требования

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

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

PerfStopProvider