vkGetShaderInstrumentationValuesARM

Data can be retrieved from an instrumentation object in units of metric blocks. The size of each metric block in bytes is sizeof(VkShaderInstrumentationMetricDataHeaderARM) + sizeof(uint64_t) × VkPhysicalDeviceShaderInstrumentationPropertiesARM::numMetrics.

To retrieve metric blocks from an instrumentation object, call:

VkResult vkGetShaderInstrumentationValuesARM(
    VkDevice device,
    VkShaderInstrumentationARM instrumentation,
    uint32_t* pMetricBlockCount,
    void* pMetricValues,
    VkShaderInstrumentationValuesFlagsARM flags);

pub fn get_shader_instrumentation_values_arm(
    device: vk::Device,
    instrumentation: vk::ShaderInstrumentationARM,
    p_metric_block_count: *mut u32,
    p_metric_values: *mut c_void,
    flags: vk::ShaderInstrumentationValuesFlagsARM,
) -> vk::Result;

• device is the logical device that was used to capture shader instrumentation data.
• instrumentation is the shader instrumentation object to retrieve values from
• pMetricBlockCount is a pointer to an integer related to the number of metric blocks available or queried.
• pMetricValues is either NULL or a pointer to an application-allocated buffer where the results will be written.
• flags is reserved for future use.

If pMetricValues is NULL, then the number of metric blocks available is returned in pMetricBlockCount. Otherwise, pMetricBlockCount must point to a variable set by the application to the number of elements in the pMetricValues array, and on return the variable is overwritten with the number of metric blocks actually written to pMetricValues. If pMetricBlockCount is less than the number of metric blocks available, at most pMetricBlockCount elements will be written, and VK_INCOMPLETE will be returned instead of VK_SUCCESS, to indicate that not all the available metric blocks were returned.

Metrics are written to pMetricValues as a tightly packed array of metric blocks, where each block consists of a VkShaderInstrumentationMetricDataHeaderARM header followed by VkPhysicalDeviceShaderInstrumentationPropertiesARM::numMetrics unsigned 64-bit values. The order of the metrics matches the order in which they are enumerated by vkEnumeratePhysicalDeviceShaderInstrumentationMetricsARM.