GpaGetSampleResultSize

语法

GpaStatus GpaGetSampleResultSize(
    GpaSessionId session_id,
    GpaUInt32 sample_id,
    size_t* sample_result_size_in_bytes);

描述

获取给定样本的结果大小（以字节为单位）。对于离散计数器样本，所有样本的大小都将相同，因此可以检索一个样本的结果大小，并在检索所有样本的结果时使用该大小。检索到的大小应传递给 GpaGetSampleResult 以获取实际结果。在可获得结果之前，必须完成所有命令列表（DirectX 12）或命令缓冲区（Vulkan）的执行。

参数

名称	描述
session_id	先前创建的会话的唯一标识符。
sample_id	先前创建的样本的唯一标识符。
sample_result_size_in_bytes	成功执行后将设置为结果大小的值 - 此值需要传递给 GpaGetSampleResult。

返回值

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