GpaGetEnabledIndex

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

语法

GpaStatus GpaGetEnabledIndex(
    GpaSessionId session_id,
    GpaUInt32 enabled_number,
    GpaUInt32* enabled_counter_index);

描述

获取已启用计数器的索引。此函数应与 GpaGetNumEnabledCounters 一起使用。在确定了已启用计数器的数量后，您可以使用 GpaGetEnabledIndex 来确定哪些计数器已启用。

参数

名称	描述
session_id	先前创建的会话的唯一标识符。
enabled_number	要为其获取计数器索引的已启用计数器的编号。必须在 0 和 (GpaGetNumEnabledCounters 的结果 - 1) 之间。
enabled_counter_index	成功执行后将包含计数器索引的值。

返回值

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

提供的 enabled_counter_index 参数为 NULL。 | | kGpaStatusErrorSessionNotFound | 未识别提供的 session_id 参数为先前创建的会话标识符。 | | kGpaStatusErrorContextNotOpen | 所提供的会话的父上下文当前未打开。 | | kGpaStatusErrorIndexOutOfRange | 提供的 enabled_number 超出了范围。 | | kGpaStatusErrorFailed | 无法检索计数器索引。 | | kGpaStatusErrorException | 发生异常。 |