MPI_Comm_free函式
釋放與 MPI_Comm_dup、 MPI_Comm_create或 MPI_Comm_split 函式一起配置的 communicator。
語法
int MPIAPI MPI_Comm_free(
_Inout_ MPI_Comm *comm
);
參數
-
通訊
要釋放之 Communicator 控制碼的指標。
傳回值
傳回成功時 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 |