17.2.365. MPI_T_pvar_read
MPI_T_pvar_read — 读取性能变量的值
17.2.365.1. 语法
17.2.365.1.1. C语法
#include <mpi.h>
int MPI_T_pvar_read(MPI_T_pvar_session session, MPI_T_pvar_handle handle, const void *buf)
17.2.365.2. 输入参数
session: 性能实验会话。handle: 性能变量句柄。buf: 变量值存储位置的初始地址。
17.2.365.3. 描述
MPI_T_pvar_read 查询由session指定会话中handle标识的性能变量的值。结果存储在buf指向的缓冲区中。调用者必须确保buf指向的缓冲区足够大以容纳性能变量的整个值。
17.2.365.4. 错误
MPI_T_pvar_read 在以下情况下会失败：
MPI_T_ERR_NOT_INITIALIZED: MPI工具接口未初始化MPI_T_ERR_INVALID_HANDLE: 句柄无效或未与会话关联MPI_T_ERR_INVALID_SESSION: 会话参数不是有效的会话