GpaDisableCounterByName

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

语法

GpaStatus GpaDisableCounterByName(
    GpsSessionId session_id,
    const char* counter_name);

描述

禁用具有指定计数器名称（不区分大小写）的计数器。后续的采样会话将不会提供任何已禁用计数器的值。最初所有计数器都已禁用，必须显式启用。

参数

名称	描述
session_id	先前创建的会话的唯一标识符。
counter_name	要禁用的计数器名称。

返回值

返回值	描述
kGpaStatusOk	指定的计数器已成功禁用。
kGpaStatusErrorGpaNotInitialized	GPA 未初始化。请在所有其他入口点之前调用 GpaInitialize。
kGpaStatusErrorNullPointer	提供的 session_id 参数为 NULL。
kGpaStatusErrorSessionNotFound	提供的 session_id 参数未被识别为先前创建的会话标识符。
kGpaStatusErrorCannotChangeCountersWhenSampling	在调用 GpaBeginSession 后，无法更改已启用计数器的集合。
kGpaStatusErrorContextNotOpen	提供的会话的父上下文当前未打开。
kGpaStatusErrorNotEnabled	指定的计数器当前未启用。
kGpaStatusErrorCounterNotFound	指定的计数器名称无效。
kGpaStatusErrorFailed	尝试禁用计数器时发生错误。
kGpaStatusErrorException	发生异常。