функция 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 2012 MS-MPI, пакет HPC 2008 R2 распространяемый пакет MS-MPI, пакет HPC 2008 MS-MPI или клиентские служебные программы пакета HPC 2008
Заголовок	Mpi.h; Mpif.h
Библиотека	Msmpi.lib
DLL	Msmpi.dll

См. также раздел

Функции коммуникатора MPI

MPI_Comm_create

MPI_Comm_split

MPI_Comm_dup