MPI_Request_get_status 函数

请求完成的非破坏性测试。

语法

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

参数

  • 请求
    通信请求。

  • flag [out]
    如果操作已完成,则为 True。

  • status [out]
    Status 对象或 MPI_STATUS_IGNORE

返回值

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

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

Fortran

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

注解

MPI_Test不同, MPI_Request_get_status 不会解除分配或停用请求。 应调用某个测试/等待例程或 MPI_Request_free 来释放请求对象。

要求

产品

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 点到点函数