MPI_Test 函数

测试未完成的操作以完成。

语法

int MPIAPI MPI_Test(
  _Inout_  MPI_Request *request,
  _Out_   int          *flag,
  _Out_   MPI_Status   *status
);

参数

  • request [in, out]
    指向未完成操作 MPI_Request 句柄的指针。

  • flag [out]
    返回时,包含指向整数的指针,该整数指示请求是否已完成。 非零值指示请求已完成。

  • status [out]
    返回时,包含指向 MPI_Status 对象的指针,该对象描述指定的操作(如果完成)。

返回值

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

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

Fortran

    MPI_WAIT(REQUEST, FLAG, STATUS, IERROR)
        LOGICAL FLAG
        INTEGER REQUEST, STATUS(MPI_STATUS_SIZE), IERROR

注解

此函数是本地操作。 成功完成不依赖于其他进程中的任何操作。

如果与此请求关联的操作是永久性通信操作,则持久请求将标记为非活动。 其他操作将解除分配,并且请求句柄设置为 MPI_REQUEST_NULL

如果 请求 参数指向 值 MPI_REQUEST_NULL 或非活动持久请求,则函数返回 标志 参数设置为非零值, 状态 参数为空。

要求

产品

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_Wait

MPI_Status

MPI_Testany

MPI_Testall

MPI_Testsome