Intel® Graphics Performance Analyzers User Guide

ID 767266
Date 3/15/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Visible to Intel only — GUID: GUID-C771C151-2266-4E51-8167-288D63635D80

Document Table of Contents

Relation API

Relation API binds two named instances, for example, tasks, with a reasonable relation attribute. Relations can be added before or after the actual instances are created and persist independently of the instances.

To logically group a bunch of tasks, you can use different types of relations:

void ITTAPI __itt_relation_add(const __itt_domain *domain, __itt_id head, __itt_relation relation, __itt_id tail)

void ITTAPI __itt_relation_add_ex(const __itt_domain *domain, __itt_clock_domain* clock_domain, unsigned long long timestamp, __itt_id head, __itt_relation relation, __itt_id tail)

Parameters of the primitives:

Type Parameter Description
[in] __itt_domain* domain

Relation domain

[in] __itt_relation relation

User-defined logical relation between two named instances

[in] __itt_id head

Metadata name

[in] __itt_id tail

IDs of two named related instances size_t count

[in] __itt_clock_domain* clock_domain

User-defined clock domain