MPI_Waitsome függvény

A számos kiemelkedő művelet közül néhányat végrehajt.

Szintaxis

int MPIAPI MPI_Waitsome(
        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)     *array_of_statuses
);

Paraméterek

• incount
  A array_of_requests paraméter bejegyzéseinek száma.

• array_of_requests
  A ki nem egyenlített műveletek MPI_Request fogópontjaiból álló tömb.

• outcount [out]
  A befejezett kérések száma.

• array_of_indices
  A befejezett műveletek array_of_requests indexek tömbje. A array_of_requests indexelése nulláról C-ben és egy Fortran-ból történik.

• array_of_statuses
  A befejezett vagy MPI_STATUSES_IGNORE műveletek állapotobjektumainak tömbje.

Visszatérési érték

Sikeres MPI_SUCCESS ad vissza. Ellenkező esetben a visszatérési érték hibakód.

A Fortranban a visszatérési érték az IERROR paraméterben lesz tárolva.

Fortran

    MPI_WAITSOME(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

Megjegyzések

Az indexek tömbje a 0 és az incount közötti tartományban van – 1 a C és az 1 és a Fortran közötti tartományban .

A NULL kérések figyelmen kívül lesznek hagyva; ha az összes kérelem NULL értékű, akkor a rutin a MPI_UNDEFINED értékre beállított outcount értékkel tér vissza.

Bár az array_of_requests egy kérelemkezelőt többször is fel lehet sorolni, az ilyen művelet tévesnek minősül, és a program nem meghatározott módon leállhat, vagy helytelen eredményeket eredményezhet.

MPI_Waitsome a Unix "select" vagy "poll" hívásaihoz hasonló felületet biztosít, és magas szintű qualilty implementáció esetén az összes olyan kérést jelzi, amely MPI_Waitsome meghívásakor befejeződött. Azonban MPI_Waitsome csak azt garantálja, hogy legalább egy kérelem befejeződött; nincs garancia arra, hogy az összes befejezett kérés vissza lesz adva, vagy hogy a array_of_indices bejegyzései növekvő sorrendben lesznek. Emellett a MPI_Waitsome végrehajtása közben befejezett kérések is visszaadhatók az üzenet befejezésének időzítésétől függően.

Követelmények

Termék	HPC Pack 2012 MS-MPI terjeszthető csomag, HPC Pack 2008 R2 MS-MPI terjeszthető csomag, HPC Pack 2008 MS-MPI terjeszthető csomag vagy HPC Pack 2008 Client Utilities
Fejléc	Mpi.h; Mpif.h
Kódtár	Msmpi.lib
DLL	Msmpi.dll

Lásd még

MPI pont–pont függvények