MPI_Comm_free 函数
释放与 MPI_Comm_dup、 MPI_Comm_create或MPI_Comm_split函数一起分配 的 通信器。
语法
int MPIAPI MPI_Comm_free(
_Inout_ MPI_Comm *comm
);
参数
-
comm
指向要释放的通信器句柄的指针。
返回值
返回成功 时MPI_SUCCESS 。 否则，返回值为错误代码。
在 Fortran 中，返回值存储在 IERROR 参数中。
Fortran
MPI_COMM_FREE(COMM,IERROR)
INTEGER COMM, IERROR
注解
此集体操作标记解除分配的通信对象。 句柄设置为 MPI_COMM_NULL。 使用此通信器的任何挂起操作正常完成。 在对象没有活动引用之前，不会解除分配该对象。
此函数同时适用于内部通信器和通信间通信器。
所有缓存属性的删除回调函数按不确定的顺序调用。
要求
产品 |
HPC Pack 2012 MS-MPI 可再发行程序包、HPC Pack 2008 R2 MS-MPI 可再发行程序包、HPC Pack 2008 MS-MPI 可再发行程序包或 HPC Pack 2008 客户端实用工具 |
标头 |
Mpi.h;Mpif.h |
库 |
Msmpi.lib |
DLL |
Msmpi.dll |