GpaCopySecondarySamples

Syntax

Copied!

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

Description

Copies a set of samples from a secondary command list back to the primary command list that executed the secondary command list. This function is only supported for DirectX 12 and Vulkan. You cannot collect data for samples created on secondary command lists unless they are first copied to a new set of samples on the primary command list.

Parameters

Name

Description

secondary_command_list_id

Unique identifier of a previously-created command list. This represents the secondary command list that acts as the source of the samples being copied.

primary_command_list_id

Unique identifier of a previously-created command list. This represents the primary command list that acts as the destination of the samples being copied.

num_samples

The number of samples to copy.

new_sample_ids

An array of the sample ids which should be copied from the secondary command list to the primary command list.

Return value

Return value

Description

kGpaStatusOk

The samples were successfully copied.

kGpaStatusErrorNullPointer
The supplied secondary_command_list_id parameter is NULL.
The supplied primary_command_list_id parameter is NULL.

kGpaStatusErrorCommandListNotFound
The supplied secondary_command_list_id parameter was not recognized as a previously-created command list identifier.
The supplied primary_command_list_id parameter was not recognized as a previously-created command list identifier.

kGpaStatusErrorApiNotSupported

This function is not supported for the current API. Only DirectX 12 and Vulkan support this API.

kGpaStatusErrorFailed

The samples could not be copied.

kGpaStatusErrorException

Exception occurred.