Visible to Intel only — GUID: GUID-D8F5B2D3-4D79-4944-8439-77F0F4B1CA0E
Introduction to Intel® Graphics Performance Analyzers
Game Optimization Methodology
Install and Launch Intel® GPA
Launch Application for Analysis
Configure Analysis Settings
Analyze Desktop Graphics Applications
Quick Start with Profiling Unreal Engine* Games
Instrumentation and Tracing Technology API Support
Intel® GPA Reference
Notices and Disclaimers
Visible to Intel only — GUID: GUID-D8F5B2D3-4D79-4944-8439-77F0F4B1CA0E
Counter API
A Counter is a user-defined characteristic or metric of hardware or software behavior that can be used to collect information about and correlate with execution breakdown, such as tasks, events, and markers. For example, system on a chip (SoC) development benefits from several counters representing different parts of the SoC to count some hardware characteristics.
Define and create a counter object
Use these primitives:
__itt_counter ITTAPI __itt_counter_create_typedA __itt_counter_create_typedA(const char *name, const char *domain, __itt_metadata_type type)
__itt_counter ITTAPI __itt_counter_create_typedW __itt_counter_create_typedW(const wchar_t *name, const wchar_t *domain, __itt_metadata_type type)
__itt_counter_create_v3(__itt_domain* domain, const char* name,__itt_metadata_type type);
Parameters of the primitives:
[in] |
domain |
Counter domain |
[in] |
name |
Counter name |
[in] |
type |
Counter type |
Use these primitives:
Directly set the counter value
Use:
__itt_counter_set_value(__itt_counter id, void *value_ptr);
__itt_counter_set_value_v3(__itt_counter counter, void *value_ptr);
Parameters of the primitive:
[in] |
id |
Counter ID |
[in] |
value_ptr |
Counter value |
Usage Example
This example creates a counter that measures temperature and memory usage metrics:
#include "ittnotify.h"
__itt_counter temperatureCounter = __itt_counter_create("Temperature", "Domain");
__itt_counter memoryUsageCounter = __itt_counter_create("Memory Usage", "Domain");
unsigned __int64 temperature;
while (...)
{
...
temperature = getTemperature();
__itt_counter_set_value(temperatureCounter, &temperature);
__itt_counter_inc_delta(memoryUsageCounter, getAllocatedMemSize());
__itt_counter_dec_delta(memoryUsageCounter, getDeallocatedMemSize());
...
}
__itt_counter_destroy(temperatureCounter);
__itt_counter_destroy(memoryUsageCounter);