GpaDisableCounter

Copyright (c) 2018-2024 Advanced Micro Devices, Inc. 保留所有权利。

语法

GpaStatus GpaDisableCounter(
    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	指定的索引超出范围。
kGpaStatusErrorNotEnabled	指定的计数器当前未启用。
kGpaStatusErrorFailed	禁用计数器时发生错误。
kGpaStatusErrorException	发生异常。