다음을 통해 공유


MPI_Comm_free 함수

MPI_Comm_dup, MPI_Comm_create 또는 MPI_Comm_split 함수와 함께 할당된 통신기를 해제합니다.

구문

int MPIAPI MPI_Comm_free(
   _Inout_ MPI_Comm *comm
);

매개 변수

  • 통신
    해제할 통신기 핸들에 대한 포인터입니다.

반환 값

성공에 대한 MPI_SUCCESS 반환합니다. 그렇지 않으면 반환 값이 오류 코드입니다.

Fortran에서 반환 값은 IERROR 매개 변수에 저장됩니다.

Fortran

    MPI_COMM_FREE(COMM,IERROR)
        INTEGER COMM, IERROR

설명

이 집단 연산은 통신 개체의 할당을 취소하는 것으로 표시합니다. 핸들이 MPI_COMM_NULL 설정됩니다. 이 통신기를 사용하는 보류 중인 작업은 정상적으로 완료됩니다. 개체에 대한 활성 참조가 없을 때까지 개체의 할당이 취소되지 않습니다.

이 함수는 통신 내 및 상호 통신기 모두에 적용됩니다.

캐시된 모든 특성에 대한 삭제 콜백 함수는 확정되지 않은 순서로 호출됩니다.

요구 사항

제품

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

추가 정보

MPI Communicator 함수

MPI_Comm_create

MPI_Comm_split

MPI_Comm_dup