CounterInitialize 函数

注册提供程序并初始化计数器集。

语法

ULONG WINAPI CounterInitialize(void);

parameters

此函数没有参数。

返回值

返回成功时ERROR_SUCCESS;否则为标准 Win32 错误代码。

备注

提供程序调用此函数。 函数包括对 PerfStartProvider 函数和 PerfSetCounterSetInfo 函数的 调用。

指定 -o 参数时，CTRPP 工具将生成此内联函数。 如果指定 -prefix 参数，则函数的名称包括前缀字符串。

如果指定 -MemoryRoutines 或 -NotificationCallback 参数 (或指定提供程序元素) 的回调属性，则 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

PERFLIB 调用以分配内存的 AllocateMemory 回调函数的名称。 如果未指定 -MemoryRoutines 参数，则设置为 NULL。

MemoryFreeFunction

PERFLIB 调用以释放使用 AllocateMemory 函数分配的内存的 FreeMemory 回调函数的名称。 如果 MemoryAllocationFunction 为 NULL，则设置为 NULL。

MemoryFunctionContext

要传递给内存分配和释放例程的上下文信息。 可以为 NULL。

要求

要求	值
最低受支持的客户端	Windows 7 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2 [仅限桌面应用]