MPI_Waitany függvény

A számos ki nem egyenlített művelet közül egyet végrehajt.

Szintaxis

int MPIAPI MPI_Waitany(
        int                              count,
        _Inout_count_(count) MPI_Request *array_of_requests,
  _Out_ int                              *index,
  _Out_ MPI_Status                       *status
);

Paraméterek

• Számít
  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.

• index [kifelé]
  Egy egész számra mutató mutató, amely a befejezett művelet array_of_requests paraméterében lévő indexet jelzi. A tömb indexelése a C-ben nulla, a Fortranban pedig egyből történik.

• status [out]
  Mutató egy MPI_Status objektumra, amely leírja a befejezett műveletet.

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 van tárolva.

Fortran

    MPI_WAITANY(COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS, IERROR)
        INTEGER COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS(MPI_STATUS_SIZE), IERROR

Megjegyzések

Ez a függvény nem helyi művelet. A sikeres végrehajtás a más folyamatokban végrehajtott egyező műveletektől függhet.

Ez a függvény akkor ad vissza, ha a array_of_requests paraméter aktív kéréseihez társított műveletek egyike befejeződik. Ha egynél több befejezetlen művelet van végrehajtva, a rendszer tetszőlegesen kiválaszt egyet. Ha a befejezett művelet egy állandó kommunikációs művelet, az állandó kérés inaktívként lesz megjelölve. A rendszer felszabadít egy nemperzisztens műveletet, és a array_of_requests paraméter megfelelő bejegyzése MPI_REQUEST_NULL értékre van állítva.

A array_of_requests paraméter bejegyzései lehetnek MPI_REQUEST_NULL vagy egy inaktív állandó kommunikációs kérés leírója. Ha a count paraméter nulla, vagy a array_of_requests összes bejegyzése MPI_REQUEST_NULL vagy inaktív állandó kommunikációs kérés, akkor a függvény azonnal visszaadja az indexparamétertMPI_UNDEFINED értékre és üres állapotra.

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 újraterjeszthető csomag vagy HPC Pack 2008 ügyfél-segédprogramok
Fejléc	Mpi.h; Mpif.h
Kódtár	Msmpi.lib
DLL	Msmpi.dll

Lásd még

MPI pont–pont függvények

MPI_Testany

MPI_Wait

MPI_Waitall

MPI_Waitsome

MPI_Status