perflib.h 标头

性能计数器使用此标头。 有关详细信息，请参阅：

• 性能计数器

perflib.h 包含以下编程接口：

函数

PerfAddCounters 将性能计数器规范添加到指定的查询。
PerfCloseQueryHandle 关闭通过调用 PerfOpenQueryHandle 打开的查询句柄。
PerfCreateInstance 创建指定计数器集的实例。
PerfDecrementULongCounterValue 递减其值为 4 字节无符号整数的计数器的值。 提供程序使用此函数。
PerfDecrementULongLongCounterValue 递减其值为 8 字节无符号整数的计数器的值。 提供程序使用此函数。
PerfDeleteCounters 从指定的查询中删除指定的性能计数器规范。
PerfDeleteInstance 删除 PerfCreateInstance 函数创建的计数器集的实例。
PerfEnumerateCounterSet 获取在指定系统上注册的计数器集的计数器集标识符。 计数器集标识符是 (GUID) 的全局唯一标识符。
PerfEnumerateCounterSetInstances 获取指定系统上计数器集的活动实例的名称和标识符。
PerfIncrementULongCounterValue 递增其值为 4 字节无符号整数的计数器的值。 提供程序使用此函数。
PerfIncrementULongLongCounterValue 递增其值为 8 字节无符号整数的计数器的值。 提供程序使用此函数。
PerfOpenQueryHandle 创建引用指定系统上的查询的句柄。 查询是计数器规范的列表。
PerfQueryCounterData 获取与指定查询中的计数器规范匹配的性能计数器的值。
PerfQueryCounterInfo 获取指定查询中的计数器规范。
PerfQueryCounterSetRegistrationInfo 获取有关指定系统上的计数器集的信息。
PerfQueryInstance 检索指向指定计数器集实例的指针。 提供程序使用此函数。
PerfSetCounterRefValue 汇报计数器的值，其值是指向实际数据的指针。 提供程序使用此函数。
PerfSetCounterSetInfo 指定特定计数器集的布局。
PerfSetULongCounterValue 汇报其值为 4 字节无符号整数的计数器的值。 提供程序使用此函数。
PerfSetULongLongCounterValue 汇报其值为 8 字节无符号整数的计数器的值。 提供程序使用此函数。
PerfStartProvider 注册提供程序。 (PerfStartProvider)
PerfStartProviderEx 注册提供程序。 (PerfStartProviderEx)
PerfStopProvider 从已注册的提供程序列表中删除提供程序的注册，并释放与提供程序关联的所有资源。

回调函数

PERF_MEM_ALLOC 提供程序实现此函数以提供 PERFLIB 的自定义内存管理。A
PERF_MEM_FREE 提供程序实现此函数以提供 PERFLIB 的自定义内存管理。F
PERFLIBREQUEST 提供程序可以实现此函数，以在使用者执行某些操作（例如在查询中添加或删除计数器）时接收通知。

结构

PERF_COUNTER_DATA 包含有关包含 结构的 PERF_COUNTER_DATA 块的信息。
PERF_COUNTER_HEADER 包含有关包含 结构的 PERF_COUNTER_HEADER 块的信息。
PERF_COUNTER_IDENTIFIER 包含有关包含 结构的 PERF_COUNTER_IDENTIFIER 块的信息。
PERF_COUNTER_IDENTITY 定义当使用者在查询中添加或删除计数器时发送到提供程序回调的计数器。
PERF_COUNTER_INFO 定义提供程序使用的计数器的相关信息。 CTRPP 工具会根据指定的架构自动生成此结构。
PERF_COUNTER_REG_INFO 提供有关性能计数器的注册信息。
PERF_COUNTERSET_INFO 定义有关提供程序使用的计数器集的信息。 CTRPP 工具会根据指定的架构自动生成此结构。
PERF_COUNTERSET_INSTANCE 定义计数器集的实例。
PERF_COUNTERSET_REG_INFO 包含有关包含 结构的 PERF_COUNTERSET_REG_INFO 块的信息。
PERF_DATA_HEADER 提供有关包含 结构的PERF_DATA_HEADER块的信息。
PERF_INSTANCE_HEADER 提供有关包含 结构的 PERF_INSTANCE_HEADER 块的信息。
PERF_MULTI_COUNTERS 提供有关包含 结构的PERF_MULTI_COUNTERS块的信息。
PERF_MULTI_INSTANCES 提供有关包含 结构的 PERF_MULTI_INSTANCES 块的信息。
PERF_PROVIDER_CONTEXT 定义提供程序上下文信息。
PERF_STRING_BUFFER_HEADER 提供有关包含 结构的PERF_STRING_BUFFER_HEADER块的信息。
PERF_STRING_COUNTER_HEADER 指示PERF_STRING_BUFFER_HEADER块中包含所指示性能计数器的名称或帮助字符串的字符串的起始位置。

枚举

PerfCounterDataType 指示 PerfQueryCounterData 函数作为函数作为输出生成的PERF_DATA_HEADER块的一部分包含的 PERF_COUNTER_HEADER 块的内容类型。
PerfRegInfoType 指示可以通过调用 PerfQueryCounterSetRegistrationInfo 函数请求的有关性能计数器集的信息类型。