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 |
|---|---|
|
|
Unique identifier of a previously-created command list. This represents the secondary command list that acts as the source of the samples being copied. |
|
|
Unique identifier of a previously-created command list. This represents the primary command list that acts as the destination of the samples being copied. |
|
|
The number of samples to copy. |
|
|
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. |
|
kGpaStatusErrorGpaNotInitialized |
GPA was not initialized. Call GpaInitialize before all other entrypoints. |
|
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. |
