GpaGetCounterUuid

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

Syntax

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

Description

Gets the UUID type of the specified counter. The UUID can be used to uniquely identify the counter. A counter’s unique identifier can change from one version of GPA to the next.

Parameters

Name	Description
session_id	Unique identifier of a previously-created session.
index	The index of the counter whose UUID is needed. Must lie between 0 and (GpaGetNumCounters result - 1).
counter_uuid	The address which will hold the UUID upon successful execution.

Return value

Return value	Description
kGpaStatusOk	The counter UUID was successfully retrieved.
kGpaStatusErrorGpaNotInitialized	GPA was not initialized. Call GpaInitialize before all other entrypoints.
kGpaStatusErrorNullPointer	The supplied counter_uuid 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 UUID could not be retrieved. | | kGpaStatusErrorException | Exception occurred. |