연결된 키 값과 기존 통신기를 복제합니다. 각 키 값에 대해 각 복사 콜백 함수는 새 통신기에서 이 키와 연결된 특성 값을 결정합니다. 예를 들어 복사 콜백은 새 통신기에서 특성을 삭제할 수 있습니다.
구문
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 팩 2012 MS-MPI 재배포 가능 패키지, HPC 팩 2008 R2 MS-MPI 재배포 가능 패키지, HPC Pack 2008 MS-MPI 재배포 가능 패키지 또는 HPC 팩 2008 클라이언트 유틸리티 |
헤더 |
Mpi.h; Mpif.h |
라이브러리 |
Msmpi.lib |
DLL |
Msmpi.dll |