GpaBeginSession
Copyright (c) 2018-2024 Advanced Micro Devices, Inc. 保留所有权利。
语法
GpaStatus GpaBeginSession( GpaSessionId session_id);描述
使用当前启用的计数器集开始采样。必须先使用 GpaCreateSession 创建会话，然后才能启动它。在创建任何采样之前，必须启动会话。会话的已启用计数器集在会话启动后无法更改。
参数
| 名称 | 描述 |
|---|---|
| session_id | 先前创建的会话的唯一标识符。 |
返回值
| 返回值 | 描述 |
|---|---|
| kGpaStatusOk | 会话已成功启动。 |
| kGpaStatusErrorGpaNotInitialized | GPA 未初始化。请在所有其他入口点之前调用 GpaInitialize。 |
| kGpaStatusErrorNullPointer | 提供的 session_id 参数为 NULL。 |
| kGpaStatusErrorSessionNotFound | 提供的 session_id 参数未被识别为先前创建的会话标识符。 |
| kGpaStatusErrorContextNotOpen | 提供的上下文当前未打开。 |
| kGpaStatusErrorSessionAlreadyStarted | 会话已启动。 |
| kGpaStatusErrorNoCountersEnabled | 未启用任何计数器 |
| kGpaStatusErrorFailed | 会话可以启动。 |
| kGpaStatusErrorOtherSessionActive | 另一个会话正在活动中。 |
| kGpaStatusErrorException | 发生异常。 |