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

String Handle API

Many API calls require names to identify API objects. String handles are pointers to names. They enable efficient handling of named objects at run time and make collected traces data more compact.
To create and return a handle value that can be associated with a string, use the following primitive:
__itt_string_handle *ITTAPI __itt_string_handle_createA ( const char *name) __itt_string_handle *ITTAPI __itt_string_handle_createW ( const wchar_t *name)
Or use the macro in the following way:
__itt_string_handle *ITTAPI __itt_string_handle_create (__TEXT("My Task"))
Consecutive calls to
with the same name return the same value. The set of string handles is expected to remain static during the application's execution time, therefore, there is no mechanism to destroy a string handle. Any string handle can be accessed by any thread in the process, regardless of which thread created the string handle. This call is thread-safe.
Parameters of the primitives:
Input string

Product and Performance Information


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