17.2.366. MPI_T_pvar_readreset

MPI_T_pvar_readreset — 原子性地读取并重置性能变量的值

17.2.366.1. 语法

17.2.366.1.1. C语法

#include <mpi.h>

int MPI_T_pvar_readreset(MPI_T_pvar_session session, MPI_T_pvar_handle handle, const void *buf)

17.2.366.2. 输入参数

  • session: 性能实验会话。

  • handle: 性能变量句柄。

  • buf: 变量值存储位置的初始地址。

17.2.366.3. 描述

MPI_T_pvar_readreset 以原子方式查询并重置由session指定会话中handle指定句柄绑定的性能变量值。结果存储在buf指向的缓冲区中。此函数仅适用于原子且非只读的性能变量。调用者必须确保buf指向的缓冲区足够大以容纳性能变量的全部值。

17.2.366.4. 错误

MPI_T_pvar_readreset 在以下情况下会失败：

  • MPI_T_ERR_NOT_INITIALIZED: MPI工具接口未初始化

  • MPI_T_ERR_INVALID_HANDLE: 句柄无效或未与会话关联

  • MPI_T_ERR_INVALID_SESSION: 会话参数不是有效的会话

  • MPI_T_ERR_PVAR_NO_ATOMIC: 变量无法以原子方式读写

  • MPI_T_ERR_PVAR_NO_WRITE: 变量无法被重置

另请参阅