GpaGetCounterDescription
Copyright (c) 2018-2024 Advanced Micro Devices, Inc. 保留所有权利。
语法
GpaStatus GpaGetCounterDescription( GpaSessionId session_id, GpaUInt32 index, const char** description);描述
获取指定计数器的描述。
参数
| 名称 | 描述 |
|---|---|
| session_id | 先前创建的会话的唯一标识符。 |
| index | 需要其描述的计数器的索引。必须介于 0 和 (GpaGetNumCounters 结果 - 1) 之间。 |
| 描述 | 成功执行后将保存描述的地址。 |
返回值
| 返回值 | 描述 |
|---|---|
| kGpaStatusOk | 计数器描述已成功检索。 |
| kGpaStatusErrorGpaNotInitialized | GPA 未初始化。请在所有其他入口点之前调用 GpaInitialize。 |
| kGpaStatusErrorNullPointer | 提供的 description 参数为 NULL。 |
提供的 session_id 参数为 NULL。 | | kGpaStatusErrorSessionNotFound 如果提供的 session_id 无效。 | | | kGpaStatusErrorIndexOutOfRange | 指定的索引超出范围。 | | kGpaStatusErrorFailed | 无法检索计数器描述。 | | kGpaStatusErrorException | 发生异常。 |