CUPTI User's Guide

CUptiResult cuptiEventGroupSetsCreate (CUcontext context,size_t eventIdArraySizeBytes, CUpti_EventID ∗ eventIdArray,CUpti_EventGroupSets ∗∗ eventGroupPasses)The number of events that can be collected simultaneously varies by device and by thetype of the events. When events can be collected simultaneously, they may need to begrouped into multiple event groups because they are from different event domains. Thisfunction takes a set of events and determines how many passes are required to collect allthose events, and which events can be collected simultaneously in each pass.The CUpti_EventGroupSets returned in eventGroupPasses indicates how many passesare required to collect the events with the numSets field. The sets array indicates theevent groups that should be collected on each pass.Parameters:context The context for event collectioneventIdArraySizeBytes Size of eventIdArray in byteseventIdArray Array of event IDs that need to be groupedeventGroupPasses Returns a CUpti_EventGroupSets object that indicates thenumber of passes required to collect the events and the events to collect on eachpassReturn values:CUPTI_SUCCESSCUPTI_ERROR_NOT_INITIALIZEDCUPTI_ERROR_INVALID_CONTEXTCUPTI_ERROR_INVALID_EVENT_IDCUPTI_ERROR_INVALID_PARAMETER if eventIdArray or eventGroupPassesis NULLCUptiResult cuptiEventGroupSetsDestroy(CUpti_EventGroupSets ∗ eventGroupSets)Destroy a CUpti_EventGroupSets object.Parameters:eventGroupSets The object to destroyReturn values:CUPTI_SUCCESSCUPTI_ERROR_NOT_INITIALIZEDCUDA Tools SDK CUPTI User’s Guide DA-05679-001_v01 | 97