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


функция MPI_Ssend

Выполняет операцию отправки в синхронном режиме и возвращает значение, когда буфер отправки можно безопасно использовать повторно.

Синтаксис

int MPIAPI MPI_Ssend(
  _In_opt_ void         *buf,
           int          count,
           MPI_Datatype datatype,
           int          dest,
           int          tag,
           MPI_Comm     comm
);

Параметры

  • buf [in, необязательный]
    Указатель на буфер, содержащий отправляемые данные.

  • count
    Количество элементов в буфере. Если часть данных сообщения пуста, задайте для параметра count значение 0.

  • datatype
    Тип данных элементов в буфере.

  • Dest
    Ранг целевого процесса в коммуникаторе, заданный параметром comm .

  • Тег
    Тег сообщения, который можно использовать для различения сообщений разных типов.

  • Comm
    Дескриптор для коммуникатора.

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

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

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

Fortran

    MPI_SSEND(BUF, COUNT, DATATYPE, DEST, TAG, COMM, IERROR)
        <type> BUF(*)
        INTEGER COUNT, DATATYPE, DEST, TAG, COMM, IERROR

Комментарии

Эта функция не является локальной. Успешное завершение операции отправки зависит от появления соответствующей функции получения.

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

Если операции отправки и получения блокируют операции, то синхронный режим обеспечивает синхронную семантику обмена данными; обмен данными не завершается ни с того, ни с другого конца до тех пор, пока не будут завершены процессы отправки и получения.

Требования

Продукт

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

MPI_Bsend

MPI_Rsend

MPI_Recv