PerfStartProviderEx function (perflib.h)

Article
02/22/2024

Registers the provider.

Syntax

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

Parameters

[in] ProviderGuid

GUID that uniquely identifies the provider. The providerGuid attribute of the provider element specifies the GUID.

[in, optional] ProviderContext

A PERF_PROVIDER_CONTEXT structure that contains pointers to the control callback, memory management routines, and context information.

[out] Provider

Handle to the provider. You must call PerfStopProvider to release resources associated with the handle.

Return value

If the function succeeds, it returns ERROR_SUCCESS.

If the function fails, the return value is a system error code.

Remarks

The CounterInitialize function calls this function; do not call this function directly.

Windows Vista: The PerfAutoInitialize function calls this function.

The CTRPP tool includes this function instead of PerfStartProvider if you use the -MemoryRoutines argument or -NotificationCallback argument when calling CTRPP, or if the callback attribute of the provider element is set to "custom".

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	perflib.h
Library	Advapi32.lib
DLL	Advapi32.dll