pix_get_metric_values
Retrieve time-sampled metric values from a PIX capture, such as counters, CPU usage, device utilization, or memory, with summary statistics (min, max, mean).
Instructions
One metric sampled over time: a series rather than a list of events.
The lanes, and what each needs:
"pix_counter" (the default) - a counter reported while the capture ran, either by the title through PIXReportCounter or by the driver, such as the per-adapter video memory budget and usage. Takes metric_id from pix_list_timing_counters.
"cpu_usage" - one core's utilisation as a percentage, sampled every 100 ms. Takes core, plus either process_id or all_processes=true. Asking for the same core both ways is how to see whether a busy core was busy with the title or with something else.
"api_object_memory" - video memory held by one process's D3D12 objects, in bytes. Takes process_id.
"device_utilization" and "device_bandwidth" - per Win32 device. Take device_id from pix_list_storage_devices, and need a capture recorded with the ETW file provider.
in_page reports min, max, mean, first and last over the rows returned, which for a series is usually the whole question.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| core | No | ||
| limit | No | ||
| metric | No | ||
| end_time | No | ||
| device_id | No | ||
| metric_id | No | ||
| capture_id | Yes | ||
| process_id | No | ||
| start_time | No | ||
| all_processes | No | ||
| cursor_position | No | ||
| timeout_seconds | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||