17.2.353. MPI_T_cvar_handle_alloc

MPI_T_cvar_handle_alloc, MPI_T_cvar_handle_free - 分配/释放控制变量句柄

17.2.353.1. 语法

17.2.353.1.1. C语法

#include <mpi.h>

int MPI_T_cvar_handle_alloc(int cvar_index, void *obj_handle,
                            MPI_T_cvar_handle *handle, int *count)

int MPI_T_cvar_handle_free(MPI_T_cvar_handle *handle)

17.2.353.2. 描述

MPI_T_cvar_handle_alloc 将 cvar_index 中指定的控制变量绑定到 obj_handle 中指定的 MPI 对象。如果 MPI_T_cvar_get_info 返回 MPI_T_BIND_NO_OBJECT 作为变量的绑定，则忽略 obj_handle 参数。此控制变量表示的值数量将在 count 参数中返回。如果控制变量表示字符串，则 count 将是字符串的最大长度。

MPI_T_cvar_handle_free 释放由 MPI_T_cvar_handle_alloc 分配的句柄，并将 handle 参数设置为 MPI_T_CVAR_HANDLE_NULL。

17.2.353.3. 注意事项

Open MPI 目前不支持将 MPI 对象绑定到控制变量，因此 obj_handle 参数始终会被忽略。

17.2.353.4. 错误

MPI_T_cvar_handle_alloc 在以下情况下会失败：

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

  • MPI_T_ERR_INVALID_INDEX: 控制变量索引无效

  • MPI_T_ERR_OUT_OF_HANDLES: 没有更多可用句柄

MPI_T_cvar_handle_free 在以下情况下会失败：

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

  • MPI_T_ERR_INVALID_HANDLE: 句柄无效

另请参阅