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 |