функция MPI_Waitany

Статья
12/27/2023

Выполняет одну из нескольких невыполненных операций.

Синтаксис

int MPIAPI MPI_Waitany(
        int                              count,
        _Inout_count_(count) MPI_Request *array_of_requests,
  _Out_ int                              *index,
  _Out_ MPI_Status                       *status
);

Параметры

count
Количество записей в параметре array_of_requests .
array_of_requests
Массив MPI_Request дескрипторов невыполненных операций.
index [out]
Указатель на целое число, указывающее индекс в параметре array_of_requests завершенной операции. Массив индексируется от нуля в C и от одного в Fortran.
status [out]
Указатель на объект MPI_Status , описывающий завершенную операцию.

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

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

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

Fortran

    MPI_WAITANY(COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS, IERROR)
        INTEGER COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS(MPI_STATUS_SIZE), IERROR

Эта функция возвращается при завершении одной из операций, связанных с активными запросами в параметре array_of_requests . Если выполнено несколько невыполненных операций, одна из них выбирается произвольно. Если завершенная операция является постоянной операцией связи, постоянный запрос помечается как неактивный. Неперсистентная операция освобождается, а ее соответствующая запись в параметре array_of_requests имеет значение MPI_REQUEST_NULL.

Записи в параметре array_of_requests могут быть MPI_REQUEST_NULL или дескриптором неактивного постоянного запроса связи. Если параметр count равен нулю или все записи в array_of_requestsMPI_REQUEST_NULL или неактивные постоянные запросы связи, функция немедленно возвращается с параметром индекса , заданным MPI_UNDEFINED и пустым состоянием.

Требования

Продукт	Распространяемый пакет HPC 2012 MS-MPI, пакет HPC 2008 R2 распространяемый пакет MS-MPI, пакет HPC 2008 MS-MPI распространяемый пакет или служебные программы клиента ПАКЕТА HPC 2008
Заголовок	Mpi.h; Mpif.h
Библиотека	Msmpi.lib
DLL	Msmpi.dll