PerfStartProviderEx 函数 (perflib.h)

注册提供程序。

语法

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

参数

[in] ProviderGuid

唯一标识提供程序的 GUID。 provider 元素的 providerGuid 属性指定 GUID。

[in, optional] ProviderContext

包含指向控件回调、内存管理例程和上下文信息的指针 的PERF_PROVIDER_CONTEXT 结构。

[out] Provider

提供程序的句柄。 必须调用 PerfStopProvider 才能释放与句柄关联的资源。

返回值

如果函数成功,则返回ERROR_SUCCESS。

如果函数失败,则返回值为 系统错误代码

注解

CounterInitialize 函数调用此函数;请勿直接调用此函数。

Windows Vista: PerfAutoInitialize 函数调用此函数。

如果在调用 CTRPP 时使用 -MemoryRoutines 参数或 -NotificationCallback 参数,或者提供程序元素的回调属性设置为“custom”,则 CTRPP 工具包括此函数而不是 PerfStartProvider

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 perflib.h
Library Advapi32.lib
DLL Advapi32.dll

另请参阅

PerfStopProvider