• Intel® Graphics Performance Analyzers 2020 R1
  • 03/31/2020
  • Public Content
Contents

Thread Naming API

By default, each thread in your application is displayed in the
timeline
track with a default label generated from the process ID and the thread ID, or with the OS thread name. You can use the Thread Naming API in your code to give threads meaningful names.
To set a thread name using a char or UNICODE string, use the following primitive:
void __itt_thread_set_nameA (const __itt_char *name) void __itt_thread_set_nameW (const wchar_t *name)
Or use the macro in the following way:
void__itt_thread_set_name(__TEXT("Main"))
Parameters of the primitive:
[in]
name
Thread name
 
 
If the thread name is set multiple times, only the last name is used.
Usage Example
You can use the following thread naming example to give meaningful names to the threads you wish to focus on.
DWORD WINAPI service_thread(LPVOID lpArg) { __itt_thread_set_name(__TEXT("My service thread")); // Do thread work here return 0; } DWORD WINAPI thread_function(LPVOID lpArg) { __itt_thread_set_name(__TEXT("My worker thread")); // Do thread work here return 0; } int main(int argc, char* argv[]) { ... CreateThread(NULL, 0, service_thread, NULL, 0, NULL); CreateThread(NULL, 0, thread_function, NULL, 0, NULL); ... return 0; }

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804