pm_set_counter_频率-pthread ，pm_set_counter_频率-线程或pm_set_counter_频率-mythread 子例程
用途
配置目标线程的计数器频率。
库
性能监视器 API 库 (libpmapi.a)
语法
#include <pmapi.h>
int pm_set_counter_frequency_pthread (pid_t pid, tid_t tid,
ptid_t ptid,
unsigned counter_freq [MAX_COUNTERS])
int pm_set_counter_frequency_thread (pid_t pid, tid_t tid,
unsigned counter_freq [MAX_COUNTERS])
int pm_set_counter_frequency_mythread (unsigned counter_freq [MAX_COUNTERS])描述
pm_set_counter_频率-pthread， pm_set_counter_频率-线程或 pm_set_counter_频率-mythread 子例程在性能监视器计数器 (PMC) 中配置给定线程的计数器频率值。
必须使用 pm_set_counter_frequency ency_pthread 子例程来配置目标 pthread 的计数器频率。
必须使用 pm_set_counter_frequency ency_thread 子例程来配置目标内核线程的计数器频率。
必须使用 pm_set_Counterency_mythread 子例程来配置自线程的计数器频率。
参数
| 项 | 描述 |
|---|---|
| pid | 目标线程的进程标识。 |
| tid | 目标线程的内核线程标识。 如果不需要该参数，那么可以将该值设置为零。 |
| ptid | 目标线程的 Pthread 标识。 如果不需要该参数，那么可以将该值设置为零。 |
| 反变量 (counter_freq) | 相应的 PMC 的计数器频率。 |
返回值
如果不成功，那么将返回除零以外的值并设置正错误代码。 如果成功，将返回值 0。
错误代码
如果返回以下错误代码，那么子例程不成功:
| 项 | 描述 |
|---|---|
| Pmapi_NoInit | 未调用 pm_initialize 子例程。 |
| Pmapi_NoSetProg | 未调用 pm_set_program 子例程。 |
| 其他非零错误代码 | 由 pmsvcs 子例程返回。 |
文件
pmapi.h 文件定义标准宏，数据类型和子例程。