GpaGetSampleCount

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

语法

GpaStatus GpaGetSampleCount(
    GpaSessionId session_id,
    GpaUInt32* sample_count);

描述

获取为指定会话创建的样本数。如果样本是条件创建且未跟踪计数，则此功能很有用。调用此函数之前，必须已通过 GpaEndSession 结束会话。

参数

名称	描述
session_id	先前创建的会话的唯一标识符。
sample_count	成功执行后，将保存会话中样本数的变量。

返回值

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

提供的 sample_count 参数为 NULL。 | | kGpaStatusErrorSessionNotFound | 未识别提供的 session_id 参数为先前创建的会话标识符。 | | kGpaStatusErrorSessionNotEnded | 会话尚未结束。在查询样本数之前，必须已通过 GpaEndSession 结束会话。 | | kGpaStatusErrorFailed | 无法检索样本数。 | | kGpaStatusErrorException | 发生异常。 |