GpaGetCounterUuid

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

语法

GpaStatus GpaGetCounterUuid(
    GpaSessionId session_id,
    GpaUInt32 index,
    GpaUuid* counter_uuid);

描述

获取指定计数器的 UUID 类型。UUID 可用于唯一标识该计数器。计数器的唯一标识符可能在 GPA 的不同版本之间发生变化。

参数

名称	描述
session_id	先前创建的会话的唯一标识符。
index	需要 UUID 的计数器的索引。必须在 0 和 (GpaGetNumCounters 的结果 - 1) 之间。
counter_uuid	成功执行时将保存 UUID 的地址。

返回值

返回值	描述
kGpaStatusOk	计数器 UUID 已成功检索。
kGpaStatusErrorGpaNotInitialized	GPA 未初始化。请在所有其他入口点之前调用 GpaInitialize。
kGpaStatusErrorNullPointer	提供的 counter_uuid 参数为 NULL。

提供的 session_id 参数为 NULL。 | | kGpaStatusErrorSessionNotFound 如果提供的 session_id 无效。 | | | kGpaStatusErrorIndexOutOfRange | 指定的索引超出范围。 | | kGpaStatusErrorFailed | 无法检索计数器 UUID。 | | kGpaStatusErrorException | 发生异常。 |