MPI_Irecv függvény

Kezdeményez egy fogadási műveletet, és visszaad egy leírót a kért kommunikációs műveletnek.

Szintaxis

int MPIAPI MPI_Irecv(
  _In_opt_ void         *buf,
           int          count,
           MPI_Datatype datatype,
           int          source,
           int          tag,
           MPI_Comm     comm,
  _Out_    MPI_Request  *request
);

Paraméterek

• buf [in, nem kötelező]
  Az elküldendő adatokat tartalmazó pufferre mutató mutató.

• Számít
  A puffertömb elemeinek száma. Ha az üzenet adatrésze üres, állítsa a count paramétert 0-ra.

• Adattípus
  A puffer elemeinek adattípusa.

• Forrás
  A küldési folyamat rangja a megadott kommunikátorban. Adja meg a MPI_ANY_SOURCE konstanst, hogy bármely forrás elfogadható legyen.

• Tag
  A különböző típusú üzenetek megkülönböztetésére használható üzenetcímke. Adja meg a MPI_ANY_TAG állandót, amely azt jelzi, hogy bármely címke elfogadható.

• Comm
  A kommunikátor fogantyúja.

• request [out]
  Visszaküldéskor a rendszer egy leírót tartalmaz a kért kommunikációs művelethez.

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_IRECV(BUF, COUNT, DATATYPE, SOURCE, TAG, COMM, REQUEST, IERROR)
        <type> BUF(*)
        INTEGER COUNT, DATATYPE, SOURCE, TAG, COMM, REQUEST, IERROR

Megjegyzések

Ez a függvény helyi, azonnal visszatér, és nem vár semmilyen más folyamatra. Ez a függvény vissza tud térni, mielőtt az üzenet bekerül a pufferbe.

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_Send

MPI_Recv

MPI_Wait

MPI_Test

MPI_Comm

MPI_Datatype