Поделиться через


функция MPI_Request_free

Освобождает объект запроса на связь.

Синтаксис

int MPIAPI MPI_Request_free(
   _Inout_ MPI_Request *request
);

Параметры

  • request
    Запрос на связь.

Возвращаемое значение

Возвращает MPI_SUCCESS при успешном выполнении. В противном случае возвращаемое значение представляет собой код ошибки.

В Fortran возвращаемое значение хранится в параметре IERROR .

Fortran

    MPI_REQUEST_FREE(REQUEST, IERROR)
        INTEGER REQUEST, IERROR

Комментарии

Эта подпрограмма обычно используется для освобождения неактивных постоянных запросов, созданных с помощью MPI_Recv_init или MPI_Send_init и друзей. Также допускается освобождение активного запроса. Однако после освобождения запрос больше не может использоваться в подпрограмме ожидания или тестирования (например, MPI_Wait) для определения завершения.

Эта подпрограмма также может использоваться для освобождения непостояных запросов, таких как запросы, созданные с помощью MPI_Irecv или MPI_Isend и друзей. Как и активные постоянные запросы, после освобождения запрос больше не может использоваться с подпрограммами тестирования и ожидания для определения завершения.

Требования

Продукт

Распространяемый пакет 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