MPI_Testsome 函数

测试要完成的一些给定请求。

语法

int MPIAPI MPI_Testsome(
        int                                                incount,
        _Inout_count_(incount) MPI_Request                 *array_of_requests,
  _Out_ int                                                *outcount,
        _Out_cap_post_count_(incount,*outcount) int        *array_of_indices,
        _Out_cap_post_count_(incount,*outcount) MPI_Status *array_of_statuses
);

参数

• incount
  array_of_requests 参数中的条目数。

• array_of_requests
  未完成操作 的MPI_Request 句柄数组。

• outcount [out]
  已完成的请求数。

• array_of_indices
  已完成的操作 array_of_requests 中的索引数组。 array_of_requests从 C 中的零索引，从 Fortran 中的 1 索引。

• array_of_statuses
  已完成或 MPI_STATUSES_IGNORE的操作的状态对象的数组。

返回值

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

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

Fortran

    MPI_TESTSOME(INCOUNT, ARRAY_OF_REQUESTS, OUTCOUNT, ARRAY_OF_INDICES, ARRAY_OF_STATUSES, IERROR)
        INTEGER INCOUNT, ARRAY_OF_REQUESTS(*), OUTCOUNT, ARRAY_OF_INDICES(*),
        ARRAY_OF_STATUSES(MPI_STATUS_SIZE,*), IERROR

注解

虽然可以在 array_of_requests中多次列出请求句柄，但此类操作被视为错误，并可能导致程序意外终止或产生不正确的结果。

要求

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