Skip to content

GpaGetCounterDescription

Copyright (c) 2018-2024 Advanced Micro Devices, Inc. All rights reserved.

Syntax

GpaStatus GpaGetCounterDescription(
GpaSessionId session_id,
GpaUInt32 index,
const char** description);

Description

Gets the description of the specified counter.

Parameters

NameDescription
session_idUnique identifier of a previously-created session.
indexThe index of the counter whose description is needed. Must lie between 0 and (GpaGetNumCounters result - 1).
descriptionThe address which will hold the description upon successful execution.

Return value

Return valueDescription
kGpaStatusOkThe counter description was successfully retrieved.
kGpaStatusErrorGpaNotInitializedGPA was not initialized. Call GpaInitialize before all other entrypoints.
kGpaStatusErrorNullPointerThe supplied description parameter is NULL.

The supplied session_id parameter is NULL. | | kGpaStatusErrorSessionNotFound If the supplied session_id is invalid. | | | kGpaStatusErrorIndexOutOfRange | The specified index is out of range. | | kGpaStatusErrorFailed | The counter description could not be retrieved. | | kGpaStatusErrorException | Exception occurred. |