17.2.355. MPI_T_cvar_read

MPI_T_cvar_read — 读取控制变量的值

17.2.355.1. 语法

17.2.355.1.1. C语法

#include <mpi.h>

int MPI_T_cvar_read(MPI_T_cvar_handle handle, const void *buf)

17.2.355.2. 输入参数

  • handle: 要读取的控制变量的句柄。

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

17.2.355.3. 描述

MPI_T_cvar_read 读取由handle参数指定的控制变量的值,并将该值存储到buf指针所指向的缓冲区中。调用者必须确保buf指向的缓冲区足够大,能够容纳该控制变量的完整值。

17.2.355.4. 错误

MPI_T_cvar_read 将在以下情况下失败:

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

  • MPI_T_ERR_INVALID_HANDLE: 句柄无效