17.2.369. MPI_T_pvar_session_free

MPI_T_pvar_session_create, MPI_T_pvar_session_free - 创建/释放性能变量会话

17.2.369.1. 语法

17.2.369.1.1. C语法

#include <mpi.h>

int MPI_T_pvar_session_create(MPI_T_pvar_session *session)

int MPI_T_pvar_session_free(MPI_T_pvar_session *session)

17.2.369.2. 描述

MPI_T_pvar_session_create 创建一个用于访问性能变量的会话。新会话将通过session参数返回。

MPI_T_pvar_session_free 释放由 MPI_T_pvar_session_create 分配的会话,并将 session 参数设置为 MPI_T_PVAR_SESSION_NULL。

17.2.369.3. 错误

MPI_T_pvar_session_create 在以下情况下会失败:

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

  • MPI_T_ERR_MEMORY: Out of memory

  • MPI_T_ERR_OUT_OF_SESSIONS: 会话资源已耗尽

MPI_T_pvar_session_free 在以下情况下会失败:

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

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