CUPTI User's Guide

Return values:CUPTI_SUCCESSCUPTI_ERROR_NOT_INITIALIZEDCUPTI_ERROR_INVALID_PARAMETER if buffer is NULL, does not havealignment of at least 8 bytes, or is not at least 1024 bytes in sizeCUptiResult cuptiActivityGetNextRecord (uint8_t ∗ buffer, size_tvalidBufferSizeBytes, CUpti_Activity ∗∗ record)This is a helper function to iterate over the activity records in a buffer. A buffer of activityrecords is typically obtained by using the cuptiActivityDequeueBuffer() function.An example of typical usage:CUpti_Activity *record = NULL;CUptiResult status = CUPTI_SUCCESS;do {status = cuptiActivityGetNextRecord(buffer, validSize, &record);if(status == CUPTI_SUCCESS) {// Use record here...}else if (status == CUPTI_ERROR_MAX_LIMIT_REACHED)break;else {goto Error;}} while (1);Parameters:buffer The buffer containing activity recordsrecord Inputs the previous record returned by cuptiActivityGetNextRecord andreturns the next activity record from the buffer. If input value if NULL, returnsthe first activity record in the buffer.validBufferSizeBytes The number of valid bytes in the buffer.Return values:CUPTI_SUCCESSCUPTI_ERROR_NOT_INITIALIZEDCUPTI_ERROR_MAX_LIMIT_REACHED if no more records in the bufferCUPTI_ERROR_INVALID_PARAMETER if buffer is NULL.CUDA Tools SDK CUPTI User’s Guide DA-05679-001_v01 | 39