функция MPI_Cancel

Отменяет запрос на связь.

Синтаксис

int MPIAPI MPI_Cancel(
  _In_ MPI_Request *request
);

Параметры

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

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

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

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

Fortran

    MPI_CANCEL(REQUEST, IERROR)
        INTEGER REQUEST, IERROR

Комментарии

Основное ожидаемое использование MPI_Cancel — в схемах с несколькими буферизациями, где выполняются спекулятивные MPI_Irecv. После завершения вычисления некоторые из этих запросов на получение могут остаться; использование MPI_Cancel позволяет пользователю отменить эти неудовлетворенные запросы.

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

Требования

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