MPI_Comm_dup 函式
複製具有相關聯索引鍵值的現有通訊器。 針對每個索引鍵值，個別的複製回呼函式會決定與新通訊器中這個索引鍵相關聯的屬性值。 例如，複製回呼可以從新的 Communicator 中刪除 屬性。
語法
int MPIAPI MPI_Comm_dup(
MPI_Comm comm,
_Out_ MPI_Comm *newcomm
);
參數
通訊
要複製的通訊器。newcomm [out]
傳回時，包含新通訊器的控制碼。 新的通訊器具有相同的群組或群組，以及來源中複製的任何快取資訊，但它包含新的內容資訊。
傳回值
傳回成功 時MPI_SUCCESS 。 否則，傳回值是錯誤碼。
在 Fortran 中，傳回值會儲存在 IERROR 參數中。
Fortran
MPI_COMM_DUP(COMM,NEWCOMM,IERROR)
INTEGER COMM, NEWCOMM, IERROR
備註
此函式會建立與原始通訊器具有相同屬性的重複通訊空間。 這包括任何屬性和拓撲。 即使有涉及來源通訊器的暫止點對點通訊，此函式仍有效。
使用者可以在平行程式開始時呼叫 MPI_Comm_dup 函式，稍後使用 MPI_Comm_free 函式釋放重複的通訊器。 您也可以使用其他通訊器管理模型。
此函式同時適用于內部通訊程式和內部通訊程式。
規格需求
產品 |
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 |