性能计数器

性能计数器技术概述。

若要开发性能计数器，需要以下标头：

• pdh.h
• perflib.h
• winperf.h

有关此技术的编程指南，请参阅：

• 性能计数器

枚举

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

函数

CounterPathCallBack 应用程序实现 CounterPathCallBack 函数，以处理“浏览”对话框返回的计数器路径字符串。
LoadPerfCounterTextStringsA 将指定初始化文件中定义的性能对象和计数器加载到计算机上。 (ANSI)
LoadPerfCounterTextStringsW 将指定初始化文件中定义的性能对象和计数器加载到计算机上。 (Unicode)
PdhAddCounterA 将指定的计数器添加到查询。 (ANSI)
PdhAddCounterW 将指定的计数器添加到查询。 (Unicode)
PdhAddEnglishCounterA 将指定的非特定语言计数器添加到查询。 (ANSI)
PdhAddEnglishCounterW 将指定的非特定语言计数器添加到查询。 (Unicode)
PdhBindInputDataSourceA 将一个或多个二进制日志文件绑定在一起，用于读取日志数据。 (ANSI)
PdhBindInputDataSourceW 将一个或多个二进制日志文件绑定在一起，用于读取日志数据。 (Unicode)
PdhBrowseCountersA 显示“浏览计数器”对话框，用户可以使用该对话框选择要添加到查询的一个或多个计数器。 若要使用数据源的句柄，请使用 PdhBrowseCountersH 函数。 (ANSI)
PdhBrowseCountersHA 显示“浏览计数器”对话框，用户可以使用该对话框选择要添加到查询的一个或多个计数器。 此函数与 PdhBrowseCounters 函数相同，只不过它支持对数据源使用句柄。 (ANSI)
PdhBrowseCountersHW 显示“浏览计数器”对话框，用户可以使用该对话框选择要添加到查询的一个或多个计数器。 此函数与 PdhBrowseCounters 函数相同，只不过它支持对数据源使用句柄。 (Unicode)
PdhBrowseCountersW 显示“浏览计数器”对话框，用户可以使用该对话框选择要添加到查询的一个或多个计数器。 若要使用数据源的句柄，请使用 PdhBrowseCountersH 函数。 (Unicode)
PdhCalculateCounterFromRawValue 计算两个原始计数器值的可显示值。
PdhCloseLog 关闭指定的日志文件。
PdhCloseQuery 关闭指定查询中包含的所有计数器，关闭与查询相关的所有句柄，并释放与查询关联的所有内存。
PdhCollectQueryData 收集指定查询中所有计数器的当前原始数据值，并更新每个计数器的状态代码。 (PdhCollectQueryData)
PdhCollectQueryDataEx 使用单独的线程收集指定查询中所有计数器的当前原始数据值。 然后，函数向应用程序定义的事件发出信号，并在返回之前等待指定的时间间隔。
PdhCollectQueryDataWithTime 收集指定查询中所有计数器的当前原始数据值，并更新每个计数器的状态代码。 (PdhCollectQueryDataWithTime)
PdhComputeCounterStatistics 从原始值数组中计算计数器的统计信息。
PdhConnectMachineA 连接到指定的计算机。 (ANSI)
PdhConnectMachineW 连接到指定的计算机。 (Unicode)
PdhEnumLogSetNamesA 枚举 DSN 中日志集的名称。 (ANSI)
PdhEnumLogSetNamesW 枚举 DSN 中日志集的名称。 (Unicode)
PdhEnumMachinesA 返回与日志文件中的计数器关联的计算机名称列表。 (PdhEnumMachinesA)
PdhEnumMachinesHA 返回与日志文件中的计数器关联的计算机名称列表。 (PdhEnumMachinesHA)
PdhEnumMachinesHW 返回与日志文件中的计数器关联的计算机名称列表。 (PdhEnumMachinesHW)
PdhEnumMachinesW 返回与日志文件中的计数器关联的计算机名称列表。 (PdhEnumMachinesW)
PdhEnumObjectItemsA 返回存在于指定计算机或指定日志文件中的指定对象的计数器和实例名称。 若要使用数据源的句柄，请使用 PdhEnumObjectItemsH 函数。 (ANSI)
PdhEnumObjectItemsHA 返回存在于指定计算机或指定日志文件中的指定对象的计数器和实例名称。 此函数与 PdhEnumObjectItems 函数相同，只不过它支持对数据源使用句柄。 (ANSI)
PdhEnumObjectItemsHW 返回存在于指定计算机或指定日志文件中的指定对象的计数器和实例名称。 此函数与 PdhEnumObjectItems 函数相同，只不过它支持对数据源使用句柄。 (Unicode)
PdhEnumObjectItemsW 返回存在于指定计算机或指定日志文件中的指定对象的计数器和实例名称。 若要使用数据源的句柄，请使用 PdhEnumObjectItemsH 函数。 (Unicode)
PdhEnumObjectsA 返回指定计算机或指定日志文件中可用的对象列表。 若要使用数据源的句柄，请使用 PdhEnumObjectsH 函数。 (ANSI)
PdhEnumObjectsHA 返回指定计算机或指定日志文件中可用的对象列表。此函数与 PdhEnumObjects 相同，只不过它支持对数据源使用句柄。 (ANSI)
PdhEnumObjectsHW 返回指定计算机或指定日志文件中可用的对象列表。此函数与 PdhEnumObjects 相同，只不过它支持对数据源使用句柄。 (Unicode)
PdhEnumObjectsW 返回指定计算机或指定日志文件中可用的对象列表。 若要使用数据源的句柄，请使用 PdhEnumObjectsH 函数。 (Unicode)
PdhExpandCounterPathA 如果未为计数器路径中的通配符字符串的计数器和计数器实例指定任何指定) ，则检查指定的计算机 (或本地计算机。 (ANSI)
PdhExpandCounterPathW 如果未为计数器路径中的通配符字符串的计数器和计数器实例指定任何指定) ，则检查指定的计算机 (或本地计算机。 (Unicode)
PdhExpandWildCardPathA 检查指定的计算机或日志文件，并返回那些与包含通配符的给定计数器路径匹配的计数器路径。 若要使用数据源的句柄，请使用 PdhExpandWildCardPathH 函数。 (ANSI)
PdhExpandWildCardPathHA 检查指定的计算机或日志文件，并返回那些与包含通配符的给定计数器路径匹配的计数器路径。此函数与 PdhExpandWildCardPath 函数相同，只不过它支持对数据源使用句柄。 (ANSI)
PdhExpandWildCardPathHW 检查指定的计算机或日志文件，并返回那些与包含通配符的给定计数器路径匹配的计数器路径。此函数与 PdhExpandWildCardPath 函数相同，只不过它支持对数据源使用句柄。 (Unicode)
PdhExpandWildCardPathW 检查指定的计算机或日志文件，并返回那些与包含通配符的给定计数器路径匹配的计数器路径。 若要使用数据源的句柄，请使用 PdhExpandWildCardPathH 函数。 (Unicode)
PdhFormatFromRawValue 计算给定原始计数器值的可显示值。
PdhGetCounterInfoA 检索有关计数器的信息，例如数据大小、计数器类型、路径和用户提供的数据值。 (ANSI)
PdhGetCounterInfoW 检索有关计数器的信息，例如数据大小、计数器类型、路径和用户提供的数据值。 (Unicode)
PdhGetCounterTimeBase 返回指定计数器的时基。
PdhGetDataSourceTimeRangeA 确定时间范围、条目数，以及包含指定输入源中性能数据的缓冲区大小（如果适用）。 若要对数据源使用句柄，请使用 PdhGetDataSourceTimeRangeH 函数。 (ANSI)
PdhGetDataSourceTimeRangeH 确定时间范围、条目数，以及包含指定输入源中性能数据的缓冲区大小（如果适用）。此函数与 PdhGetDataSourceTimeRange 函数相同，只不过它支持对数据源使用句柄。
PdhGetDataSourceTimeRangeW 确定时间范围、条目数，以及包含指定输入源中性能数据的缓冲区大小（如果适用）。 若要对数据源使用句柄，请使用 PdhGetDataSourceTimeRangeH 函数。 (Unicode)
PdhGetDefaultPerfCounterA 检索指定对象的默认计数器的名称。 此名称可用于在“浏览计数器”对话框中设置初始计数器选择。 若要对数据源使用句柄，请使用 PdhGetDefaultPerfCounterH 函数。 (ANSI)
PdhGetDefaultPerfCounterHA 检索指定对象的默认计数器的名称。 (ANSI)
PdhGetDefaultPerfCounterHW 检索指定对象的默认计数器的名称。 (Unicode)
PdhGetDefaultPerfCounterW 检索指定对象的默认计数器的名称。 此名称可用于在“浏览计数器”对话框中设置初始计数器选择。 若要对数据源使用句柄，请使用 PdhGetDefaultPerfCounterH 函数。 (Unicode)
PdhGetDefaultPerfObjectA 检索默认对象的名称。 此名称可用于在“浏览计数器”对话框中设置初始对象选择。 若要对数据源使用句柄，请使用 PdhGetDefaultPerfObjectH 函数。 (ANSI)
PdhGetDefaultPerfObjectHA 检索默认对象的名称。 (ANSI)
PdhGetDefaultPerfObjectHW 检索默认对象的名称。 (Unicode)
PdhGetDefaultPerfObjectW 检索默认对象的名称。 此名称可用于在“浏览计数器”对话框中设置初始对象选择。 若要对数据源使用句柄，请使用 PdhGetDefaultPerfObjectH 函数。 (Unicode)
PdhGetDllVersion 返回当前安装的 Pdh.dll 文件的版本。
PdhGetFormattedCounterArrayA 返回带格式的计数器值的数组。 如果要设置包含实例名称通配符的计数器的计数器值的格式，请使用此函数。 (ANSI)
PdhGetFormattedCounterArrayW 返回带格式的计数器值的数组。 如果要设置包含实例名称通配符的计数器的计数器值的格式，请使用此函数。 (Unicode)
PdhGetFormattedCounterValue 计算指定计数器的可显示值。
PdhGetLogFileSize 返回指定日志文件的大小。
PdhGetRawCounterArrayA 从指定计数器返回原始值的数组。 如果要检索包含实例名称通配符的计数器的原始计数器值，请使用此函数。 (ANSI)
PdhGetRawCounterArrayW 从指定计数器返回原始值的数组。 如果要检索包含实例名称通配符的计数器的原始计数器值，请使用此函数。 (Unicode)
PdhGetRawCounterValue 返回计数器的当前原始值。
PdhIsRealTimeQuery 确定指定的查询是否为实时查询。
PdhLookupPerfIndexByNameA 返回与指定计数器名称对应的计数器索引。 (ANSI)
PdhLookupPerfIndexByNameW 返回与指定计数器名称对应的计数器索引。 (Unicode)
PdhLookupPerfNameByIndexA 返回与指定索引对应的性能对象名称或计数器名称。 (ANSI)
PdhLookupPerfNameByIndexW 返回与指定索引对应的性能对象名称或计数器名称。 (Unicode)
PdhMakeCounterPathA 使用 PDH_COUNTER_PATH_ELEMENTS 结构中指定的成员创建完整的计数器路径。 (ANSI)
PdhMakeCounterPathW 使用 PDH_COUNTER_PATH_ELEMENTS 结构中指定的成员创建完整的计数器路径。 (Unicode)
PdhOpenLogA 打开指定的日志文件以供读取或写入。 (ANSI)
PdhOpenLogW 打开指定的日志文件以供读取或写入。 (Unicode)
PdhOpenQueryA 创建用于管理性能数据收集的新查询。 若要对数据源使用句柄，请使用 PdhOpenQueryH 函数。 (ANSI)
PdhOpenQueryH 创建用于管理性能数据收集的新查询。 此函数与 PdhOpenQuery 函数相同，只不过它支持对数据源使用句柄。
PdhOpenQueryW 创建用于管理性能数据收集的新查询。 若要对数据源使用句柄，请使用 PdhOpenQueryH 函数。 (Unicode)
PdhParseCounterPathA 分析计数器路径的元素，并将结果存储在PDH_COUNTER_PATH_ELEMENTS结构中。 (ANSI)
PdhParseCounterPathW 分析计数器路径的元素，并将结果存储在PDH_COUNTER_PATH_ELEMENTS结构中。 (Unicode)
PdhParseInstanceNameA 分析实例字符串的元素。 (ANSI)
PdhParseInstanceNameW 分析实例字符串的元素。 (Unicode)
PdhReadRawLogRecord 读取指定的二进制跟踪日志文件中的信息。
PdhRemoveCounter 从查询中删除计数器。
PdhSelectDataSourceA 显示一个对话框窗口，提示用户指定性能数据的源。 (ANSI)
PdhSelectDataSourceW 显示一个对话框窗口，提示用户指定性能数据的源。 (Unicode)
PdhSetCounterScaleFactor 设置在请求格式化计数器值时应用于指定计数器的计算值的比例因子。 如果设置了PDH_FMT_NOSCALE标志，则忽略此比例系数。
PdhSetDefaultRealTimeDataSource 指定实时数据的源。
PdhSetQueryTimeRange 可将可从日志文件读取的示例限制为指定时间范围内的示例（包括）。
PdhUpdateLogA 收集当前查询的计数器数据，并将数据写入日志文件。 (ANSI)
PdhUpdateLogFileCatalog 将日志文件目录中的信息与日志文件中的性能数据同步。
PdhUpdateLogW 收集当前查询的计数器数据，并将数据写入日志文件。 (Unicode)
PdhValidatePathA 验证计数器是否存在于计数器路径中指定的计算机上。 (ANSI)
PdhValidatePathExA 验证指定的计数器是否存在于计算机或日志文件中。 (ANSI)
PdhValidatePathExW 验证指定的计数器是否存在于计算机或日志文件中。 (Unicode)
PdhValidatePathW 验证计数器是否存在于计数器路径中指定的计算机上。 (Unicode)
PERF_MEM_ALLOC 提供程序实现此函数，为 PERFLIB 提供自定义内存管理。A
PERF_MEM_FREE 提供程序实现此函数，为 PERFLIB 提供自定义内存管理。F
PerfAddCounters 将性能计数器规范添加到指定的查询。
PerfCloseQueryHandle 关闭通过调用 PerfOpenQueryHandle 打开的查询句柄。
PerfCreateInstance 创建指定计数器集的实例。
PerfDecrementULongCounterValue 递减其值为 4 字节无符号整数的计数器的值。 提供程序使用此函数。
PerfDecrementULongLongCounterValue 递减其值为 8 字节无符号整数的计数器的值。 提供程序使用此函数。
PerfDeleteCounters 从指定的查询中删除指定的性能计数器规范。
PerfDeleteInstance 删除 PerfCreateInstance 函数创建的计数器集的实例。
PerfEnumerateCounterSet 获取在指定系统上注册的计数器集的计数器集标识符。 计数器集标识符是全局唯一标识符 (GUID) 。
PerfEnumerateCounterSetInstances 获取指定系统上设置的计数器的活动实例的名称和标识符。
PerfIncrementULongCounterValue 递增其值为 4 字节无符号整数的计数器的值。 提供程序使用此函数。
PerfIncrementULongLongCounterValue 递增其值为 8 字节无符号整数的计数器的值。 提供程序使用此函数。
PERFLIBREQUEST 提供程序可以实现此函数，以在使用者执行某些操作（例如在查询中添加或删除计数器）时接收通知。
PerfOpenQueryHandle 创建引用指定系统上的查询的句柄。 查询是计数器规范的列表。
PerfQueryCounterData 获取与指定查询中的计数器规范匹配的性能计数器的值。
PerfQueryCounterInfo 获取指定查询中的计数器规范。
PerfQueryCounterSetRegistrationInfo 获取有关指定系统上的计数器集的信息。
PerfQueryInstance 检索指向指定计数器集实例的指针。 提供程序使用此函数。
PerfSetCounterRefValue 汇报计数器的值，其值是指向实际数据的指针。 提供程序使用此函数。
PerfSetCounterSetInfo 指定特定计数器集的布局。
PerfSetULongCounterValue 汇报其值为 4 字节无符号整数的计数器的值。 提供程序使用此函数。
PerfSetULongLongCounterValue 汇报其值为 8 字节无符号整数的计数器的值。 提供程序使用此函数。
PerfStartProvider 注册提供程序。 (PerfStartProvider)
PerfStartProviderEx 注册提供程序。 (PerfStartProviderEx)
PerfStopProvider 从已注册的提供程序列表中删除提供程序的注册，并释放与提供程序关联的所有资源。
PM_CLOSE_PROC 执行性能 DLL 所需的清理。
PM_COLLECT_PROC 收集性能数据并将其返回给使用者。
UnloadPerfCounterTextStringsA 从计算机中卸载指定应用程序的性能对象和计数器。 (ANSI)
UnloadPerfCounterTextStringsW 从计算机中卸载指定应用程序的性能对象和计数器。 (Unicode)

结构

PDH_BROWSE_DLG_CONFIG_A PdhBrowseCounters 函数使用 PDH_BROWSE_DLG_CONFIG 结构来配置“浏览性能计数器”对话框。 (ANSI)
PDH_BROWSE_DLG_CONFIG_HA pdhBrowseCountersH 函数使用 PDH_BROWSE_DLG_CONFIG_H 结构来配置“浏览性能计数器”对话框。 (ANSI)
PDH_BROWSE_DLG_CONFIG_HW pdhBrowseCountersH 函数使用 PDH_BROWSE_DLG_CONFIG_H 结构来配置“浏览性能计数器”对话框。 (Unicode)
PDH_BROWSE_DLG_CONFIG_W PdhBrowseCounters 函数使用 PDH_BROWSE_DLG_CONFIG 结构来配置“浏览性能计数器”对话框。 (Unicode)
PDH_COUNTER_INFO_A PDH_COUNTER_INFO结构包含描述计数器属性的信息。 此信息还包括计数器路径。 (ANSI)
PDH_COUNTER_INFO_W PDH_COUNTER_INFO 结构包含描述计数器属性的信息。 此信息还包括计数器路径。 (Unicode)
PDH_COUNTER_PATH_ELEMENTS_A PDH_COUNTER_PATH_ELEMENTS 结构包含计数器路径的组件。 (ANSI)
PDH_COUNTER_PATH_ELEMENTS_W PDH_COUNTER_PATH_ELEMENTS 结构包含计数器路径的组件。 (Unicode)
PDH_DATA_ITEM_PATH_ELEMENTS_A PDH_DATA_ITEM_PATH_ELEMENTS 结构包含特定数据项的路径元素。 (ANSI)
PDH_DATA_ITEM_PATH_ELEMENTS_W PDH_DATA_ITEM_PATH_ELEMENTS 结构包含特定数据项的路径元素。 (Unicode)
PDH_FMT_COUNTERVALUE PDH_FMT_COUNTERVALUE 结构包含计数器的计算值及其状态。
PDH_FMT_COUNTERVALUE_ITEM_A PDH_FMT_COUNTERVALUE_ITEM 结构包含计数器的实例名称和格式化值。 (ANSI)
PDH_FMT_COUNTERVALUE_ITEM_W PDH_FMT_COUNTERVALUE_ITEM 结构包含计数器的实例名称和格式化值。 (Unicode)
PDH_RAW_COUNTER PDH_RAW_COUNTER结构返回从计数器提供程序收集的数据。 不会对数据执行翻译、格式设置或其他解释。
PDH_RAW_COUNTER_ITEM_A PDH_RAW_COUNTER_ITEM 结构包含计数器的实例名称和原始值。 (ANSI)
PDH_RAW_COUNTER_ITEM_W PDH_RAW_COUNTER_ITEM 结构包含计数器的实例名称和原始值。 (Unicode)
PDH_RAW_LOG_RECORD PDH_RAW_LOG_RECORD 结构包含有关二进制跟踪日志文件记录的信息。
PDH_STATISTICS PDH_STATISTICS 结构包含原始计数器值数组的最小值、最大值和平均值。
PDH_TIME_INFO PDH_TIME_INFO结构包含有关应用于性能数据采样的时间间隔的信息。
PERF_COUNTER_BLOCK 描述包含对象计数器的原始性能计数器数据的内存块。
PERF_COUNTER_DATA 包含有关包含 结构的 PERF_COUNTER_DATA 块的信息。
PERF_COUNTER_DEFINITION 描述性能计数器。
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_BLOCK 描述查询的性能数据块，例如提供程序返回的性能对象数，以及计算性能值时使用的基于时间的值。
PERF_DATA_HEADER 提供有关包含 结构的PERF_DATA_HEADER块的信息。
PERF_INSTANCE_DEFINITION 描述性能对象的实例。
PERF_INSTANCE_HEADER 提供有关包含 结构的 PERF_INSTANCE_HEADER 块的信息。
PERF_MULTI_COUNTERS 提供有关包含 结构的PERF_MULTI_COUNTERS块的信息。
PERF_MULTI_INSTANCES 提供有关包含 结构的 PERF_MULTI_INSTANCES 块的信息。
PERF_OBJECT_TYPE 描述特定于对象的性能信息，例如，对象的实例数和对象定义的计数器数。
PERF_PROVIDER_CONTEXT 定义提供程序上下文信息。
PERF_STRING_BUFFER_HEADER 提供有关包含 结构的PERF_STRING_BUFFER_HEADER块的信息。
PERF_STRING_COUNTER_HEADER 指示PERF_STRING_BUFFER_HEADER块中包含所指示性能计数器的名称或帮助字符串的字符串开始的位置。