GpaEnableCounter

语法

GpaStatus GpaEnableCounter(
    GpaSessionId session_id,
    GpaUInt32 index);

启用指定的计数器。后续的采样会提供所有已启用计数器的值。初始时所有计数器均禁用，必须显式启用。

名称	描述
session_id	先前创建的会话的唯一标识符。
index	要启用的计数器的索引。必须介于 0 和 (GpaGetNumCounters 的结果 - 1) 之间。

返回值	描述
kGpaStatusOk	计数器已成功启用。
kGpaStatusErrorGpaNotInitialized	GPA 未初始化。请在所有其他入口点之前调用 GpaInitialize。
kGpaStatusErrorNullPointer	提供的 session_id 参数为 NULL。
kGpaStatusErrorSessionNotFound	提供的 session_id 参数未被识别为先前创建的会话标识符。
kGpaStatusErrorCannotChangeCountersWhenSampling	在调用 GpaBeginSession 后，无法更改已启用计数器的集合。
kGpaStatusErrorIndexOutOfRange	指定的索引超出范围。
kGpaStatusErrorAlreadyEnabled	指定的计数器已被启用。
kGpaStatusErrorIncompatibleSampleTypes	提供的会话不是使用支持计数器收集的 GpaSessionSampleType 值创建的。
kGpaStatusErrorFailed	尝试启用计数器时发生错误。
kGpaStatusErrorException	发生异常。