VkGpaSampleBeginInfoAMD

The VkGpaSampleBeginInfoAMD structure is defined as:

typedef struct VkGpaSampleBeginInfoAMD {
    VkStructureType sType;
    const void* pNext;
    VkGpaSampleTypeAMD sampleType;
    VkBool32 sampleInternalOperations;
    VkBool32 cacheFlushOnCounterCollection;
    VkBool32 sqShaderMaskEnable;
    VkGpaSqShaderStageFlagsAMD sqShaderMask;
    uint32_t perfCounterCount;
    const VkGpaPerfCounterAMD* pPerfCounters;
    uint32_t streamingPerfTraceSampleInterval;
    VkDeviceSize perfCounterDeviceMemoryLimit;
    VkBool32 sqThreadTraceEnable;
    VkBool32 sqThreadTraceSuppressInstructionTokens;
    VkDeviceSize sqThreadTraceDeviceMemoryLimit;
    VkPipelineStageFlags timingPreSample;
    VkPipelineStageFlags timingPostSample;
} VkGpaSampleBeginInfoAMD;

pub struct GpaSampleBeginInfoAMD {
    s_type: vk::StructureType,
    p_next: *const c_void,
    sample_type: vk::GpaSampleTypeAMD,
    sample_internal_operations: vk::Bool32,
    cache_flush_on_counter_collection: vk::Bool32,
    sq_shader_mask_enable: vk::Bool32,
    sq_shader_mask: vk::GpaSqShaderStageFlagsAMD,
    perf_counter_count: u32,
    p_perf_counters: *const vk::GpaPerfCounterAMD,
    streaming_perf_trace_sample_interval: u32,
    perf_counter_device_memory_limit: vk::DeviceSize,
    sq_thread_trace_enable: vk::Bool32,
    sq_thread_trace_suppress_instruction_tokens: vk::Bool32,
    sq_thread_trace_device_memory_limit: vk::DeviceSize,
    timing_pre_sample: vk::PipelineStageFlags,
    timing_post_sample: vk::PipelineStageFlags,
}

• sType is a VkStructureType value identifying this structure.
• pNext is NULL or a pointer to a structure extending this structure.
• sampleType is a VkGpaSampleTypeAMD value specifying the type of sample.
• sampleInternalOperations is a boolean indicating whether internal driver operations are included in the results.
• cacheFlushOnCounterCollection is a boolean indicating whether the driver should insert cache flush and invalidate events before and after every sample.
• sqShaderMaskEnable is a boolean indicating whether sqShaderMask specifies the shader stages to sample. If VK_FALSE, all shader stages are sampled.
• sqShaderMask is a bitmask of VkGpaSqShaderStageFlagBitsAMD values specifying which shader stages to sample. Shader stage bits that are not relevant to the specific device are ignored.
• perfCounterCount is the number of counters in the pPerfCounters array
• pPerfCounters is a pointer to an array of VkGpaPerfCounterAMD structures specifying the counters to be sampled. If sampleType is VK_GPA_SAMPLE_TYPE_CUMULATIVE_AMD
pPerfCounters specifies the counters that are sampled at the beginning and at end of the sample period. If sampleType is VK_GPA_SAMPLE_TYPE_TRACE_AMD then the SPM data will be added to the samples RGP data blob.
• streamingPerfTraceSampleInterval is a value specifying the period for SPM samples in cycles, and is ignored if sampleType is not VK_GPA_SAMPLE_TYPE_TRACE_AMD.
• perfCounterDeviceMemoryLimit is a value specifying the maximum amount of GPU memory that this sample can allocate for SPM data. If sampleType is not VK_GPA_SAMPLE_TYPE_TRACE_AMD this value is ignored.
• sqThreadTraceEnable is a boolean specifying whether SQTT data should be included. If sampleType is not VK_GPA_SAMPLE_TYPE_TRACE_AMD this value is ignored.
• sqThreadTraceSuppressInstructionTokens is a boolean specifying whether instruction-level SQTT tokens should be captured. If VK_FALSE, the amount of sample data is significantly reduced. If sampleType is not VK_GPA_SAMPLE_TYPE_TRACE_AMD this value is ignored.
• sqThreadTraceDeviceMemoryLimit is a value specifying the maximum amount of GPU memory in bytes that this sample can allocate for the SQTT buffer. If 0, the maximum size to prevent dropping tokens towards the end of the sample is allocated. If sampleType is not VK_GPA_SAMPLE_TYPE_TRACE_AMD this value is ignored.
• timingPreSample is a VkPipelineStageFlags2 mask of pipeline stages specifying where the begin timestamp should take place. If sampleType is not VK_GPA_SAMPLE_TYPE_TIMING_AMD this value is ignored.
• timingPostSample is a VkPipelineStageFlags2 mask of pipeline stages specifying where the end timestamp should take place. If sampleType is not VK_GPA_SAMPLE_TYPE_TIMING_AMD this value is ignored.