GpaIsSessionComplete

语法

GpaStatus GpaIsSessionComplete(
    GpaSessionId session_id);

描述

检查会话中所有样本的结果是否可用。采样会话结束后，结果可能立即可用，也可能需要一定时间才能可用。此函数允许您确定何时可以读取会话的结果。该函数不阻塞，允许进行定期轮询。要阻塞直到样本准备就绪，请改用 GpaGetSampleResult。在结果可用之前，所有命令列表 (DirectX 12) 或命令缓冲区 (Vulkan) 的执行必须全部完成。

参数

名称	描述
session_id	先前创建的会话的唯一标识符。

返回值

返回值	描述
kGpaStatusOk	会话已完成，结果已准备就绪。
kGpaStatusErrorGpaNotInitialized	GPA 未初始化。请在所有其他入口点之前调用 GpaInitialize。
kGpaStatusErrorResultNotReady	会话尚未准备好。
kGpaStatusErrorNullPointer	提供的 session_id 参数为 NULL。
kGpaStatusErrorSessionNotFound	提供的 session_id 参数未被识别为先前创建的会话标识符。
kGpaStatusErrorSessionNotStarted	会话尚未开始。
kGpaStatusErrorSessionNotEnded	会话尚未结束。在检索结果之前，必须已使用 GpaEndSession 结束会话。
kGpaStatusErrorException	发生异常。