MPI_Imrecv függvény

Nem blokkoló fogadást hajt végre az MPI_Mprobe vagy MPI_Improbe által egyeztetett üzenetek esetében.

Szintaxis

int MPIAPI MPI_Imrecv(
  _Out_   void         *buf,
  _In_    int          count,
  _In_    MPI_Datatype datatype,
  _Inout_ MPI_Message  *message,
  _Out_   MPI_Request  *request
);

Paraméterek

• buf [ki]
  A fogadó puffer címére mutató mutató.

• count [in]
  A bufadattípus-elemeinek száma.

• datatype [in]
  A buf elemeinek MPI-adattípusa.

• message [in, out]
  Az üzenetre mutató mutatót tartalmaz.

• request [out]
  Visszatérés esetén egy mutatót tartalmaz a kommunikációs műveletet jelképező MPI_REQUEST fogóponthoz.

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_IMRECV(BUF, COUNT, DATATYPE, MESSAGE, REQUEST, IERROR)
        <type> BUF(*)
        INTEGER COUNT, DATATYPE, MESSAGE, REQUEST, IERROR

Megjegyzések

Ez a függvény a MPI_Mrecv nem blokkoló változata, és elindítja egy egyeztetett üzenet nem blokkoló fogadását. A befejezés szemantikája hasonló a MPI_Irecv.

A függvényből való visszatéréskor az üzenetleíró MPI_MESSAGE_NULL értékre van állítva.

Ha ez a függvény MPI_MESSAGE_NO_PROC üzenetargumentumként van meghívva, a hívás azonnal egy kérésobjektummal tér vissza, amely a befejezett állapotobjektumot a forrás = MPI_PROC_NULL, a címke = MPI_ANY_TAG és a count = 0 értékre állítja, mintha MPI_PROC_NULL kapott volna. A függvény hívása MPI_MESSAGE_NULL hibás.

Követelmények

Termék	Microsoft MPI v6
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_Irecv

MPI_Mrecv

MPI_Mprobe

MPI_Improbe