GpaCopySecondarySamples

语法

GpaStatus GpaCopySecondarySamples(
    GpaCommandListId secondary_command_list_id,
    GpaCommandListId primary_command_list_id,
    GpaUInt32 num_samples,
    GpaUInt32* new_sample_ids);

描述

将一组采样点从辅助命令列表复制回执行辅助命令列表的主命令列表。此函数仅支持 DirectX 12 和 Vulkan。除非辅助命令列表中的采样点首先被复制到主命令列表中的一组新采样点，否则您无法收集辅助命令列表上创建的采样点数据。

参数

名称	描述
secondary_command_list_id	先前创建的命令列表的唯一标识符。这代表了作为被复制的采样点源的辅助命令列表。
primary_command_list_id	先前创建的命令列表的唯一标识符。这代表了作为被复制采样点目标的辅助命令列表。
num_samples	要复制的采样点数量。
new_sample_ids	要从辅助命令列表复制到主命令列表的采样点 ID 数组。

返回值

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

提供的 primary_command_list_id 参数为 NULL。 | | kGpaStatusErrorCommandListNotFound | 提供的 secondary_command_list_id 参数未被识别为先前创建的命令列表标识符。