__itt_metadata_str_add

 

void ITTAPI __itt_metadata_str_add  (const __itt_domain *  domain,  

  __itt_id  id,  

  __itt_string_handle *  key,  

  const char *  data,  

  size_t  length   

 )

 

Attaches a user-specified string metadata item to a task or marker instance. The Unicode analogue of this function is __itt_metadata_wstr_add.

NOTE

The __itt_metadata_str_add function must be called from the same thread on which the target task or marker instance was traced.

Parameters:

[in] domain  The domain controlling the call  

[in] id          The identifier of the instance to which the metadata is to be added, or __itt_null to add to the current task  

[in] key        The name of the metadata  

[in] data      The metadata itself  

[in] length    The number of characters in the string, or 0 if the length is unknown but the string is null-terminated  

See Also

__itt_metadata_type
__itt_metadata_add

__itt_metadata_str_add