6.98. CUpti_ActivitySynchronization2

struct CUpti_ActivitySynchronization2

用于同步管理的活动记录。

此活动用于跟踪各种 CUDA 同步 API。(CUPTI_ACTIVITY_KIND_SYNCHRONIZATION)。

公共成员

CUpti_ActivityKind kind

活动记录类型,必须为 CUPTI_ACTIVITY_KIND_SYNCHRONIZATION。

CUpti_ActivitySynchronizationType type

记录的类型。

uint64_t start

函数的开始时间戳,单位为纳秒。

开始和结束时间戳均为 0 表示无法收集函数的时间戳信息。

uint64_t end

函数的结束时间戳,单位为纳秒。

开始和结束时间戳均为 0 表示无法收集函数的时间戳信息。

uint32_t correlationId

与此结果关联的 API 的关联 ID。

uint32_t contextId

调用同步 API 的上下文的 ID。

对于上下文同步 API,它是调用 API 的上下文 ID。对于流/事件同步,它是创建流/事件的上下文的 ID。

uint32_t streamId

调用同步 API 的计算流。

CUPTI_SYNCHRONIZATION_INVALID_VALUE 值表示该字段不适用于此记录。对于 cuCtxSynchronize、cuEventSynchronize 无效。

uint32_t cudaEventId

调用同步 API 的事件 ID。

CUPTI_SYNCHRONIZATION_INVALID_VALUE 值表示该字段不适用于此记录。对于 cuCtxSynchronize、cuStreamSynchronize 无效。

uint64_t cudaEventSyncId

用于将事件同步记录与最新的 CUDA Event 记录关联的唯一 ID。

CUpti_ActivityCudaEvent2 中添加了类似的字段,用于将同步记录与 CUDA Event 记录关联。

同一个 CUDA 事件可以多次使用,因此事件 ID 对于将同步记录与最新的 CUDA Event 记录关联来说不是唯一的。此字段将是唯一的,可用于进行所需的关联。

CUPTI_SYNCHRONIZATION_INVALID_VALUE 值表示该字段不适用于此记录。仅对与 CUDA 事件相关的同步记录有效。

uint32_t returnValue

同步记录的返回值。

使用 cuptiActivityEnableAllSyncRecords API 启用/禁用收集返回值为非零的同步记录。这将是一个 CUresult 值。

uint32_t pad

未定义。

保留供内部使用。