GpaEnableCounterByName

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

语法

GpaStatus GpaEnableCounterByName(
    GpaSessionId session_id,
    const char* counter_name);

描述

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

参数

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

返回值

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