共用方式為

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 中的一個編製索引。

  • 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 點對點函式