MPI_Irsend函数

启动就绪模式发送操作并返回表示通信操作的请求句柄。

语法

int MPIAPI MPI_Irsend(
  _In_opt_ void         *buf,
           int          count,
           MPI_Datatype datatype,
           int          dest,
           int          tag,
           MPI_Comm     comm,
  _Out_    MPI_Request  *request
);

参数

  • buf [in, optional]
    指向包含要发送的数据的缓冲区的指针。 缓冲区由 数据类型 句柄指示的 MPI_Datatype 对象的连续元素计数组成。 消息长度以元素数(而不是字节数)来指定。 在通信操作完成之前,调用方不应修改发送缓冲区的任何部分。

  • 计数
    缓冲区数组中的元素数。 如果 count 为零,则消息的数据部分为空。

  • datatype
    表示缓冲区中元素的数据类型的句柄。

  • dest
    communicator comm 参数中目标进程的排名。

  • 标签
    用于区分不同类型的消息的消息标记。

  • comm
    通信器的句柄。

  • request [out]
    返回时,指向表示通信操作的句柄的指针。

返回值

返回成功 时MPI_SUCCESS 。 否则,返回值为错误代码。

在 Fortran 中,返回值存储在 IERROR 参数中。

Fortran

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

注解

此函数可以在消息从发送缓冲区中复制出来之前返回 。 此函数是本地函数,它会立即返回,而不考虑其他进程的状态。 有关就绪通信模式的说明,请参阅 MPI_Rsend 函数的备注。

要求

产品

HPC Pack 2012 MS-MPI 可再发行程序包、HPC Pack 2008 R2 MS-MPI 可再发行程序包、HPC Pack 2008 MS-MPI 可再发行程序包或 HPC Pack 2008 客户端实用工具

标头

Mpi.h;Mpif.h

Msmpi.lib

DLL

Msmpi.dll

另请参阅

MPI 点到点函数

MPI_Rsend

MPI_Recv

MPI_Irecv

MPI_Wait

MPI_Test

MPI_Comm

MPI_Datatype