Skip to content

GpaGetDeviceName

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

Syntax

GpaStatus GpaGetDeviceName(
GpaContextId context_id,
const char** device_name);

Description

Gets the device name of the GPU associated with the specified context.

Parameters

NameDescription
context_idUnique identifier of a previously-opened context.
device_nameThe value that will be set to the device name upon successful execution.

Return value

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

The supplied context_id parameter is NULL. | | kGpaStatusErrorContextNotOpen | The supplied context is not currently open. | | kGpaStatusErrorContextNotFound | The supplied context_id parameter was not recognized as a previously-opened context identifier. | | kGpaStatusErrorFailed | The device name could not be retrieved. | | kGpaStatusErrorException | Exception occurred. |