MPI_Mprobe függvény

Üzenet mintavételeinek blokkolása. Mechanizmust biztosít az adott üzenet fogadásához, amely a mintavételi/fogadási műveletektől függetlenül megfelelt. A egyeztetett üzenet a fogadási üzenetsoron kívülre kerül, így az alkalmazás eldöntheti, hogyan fogadja az üzenetet az egyező mintavételi művelet által visszaadott információk alapján. A rendszer ezután a MPI_Mrecv vagy MPI_Imrecv függvénnyel fogadja az egyező üzenetet.

Szintaxis

int MPIAPI MPI_Mprobe(
  _In_  int         source,
  _In_  int         tag,
  _In_  MPI_Comm    comm,
  _Out_ MPI_Message *message,
  _Out_ MPI_Status  *status
);

Paraméterek

• forrás [in]
  Forrásrang vagy MPI_ANY_SOURCE.

• tag [in]
  Üzenetcímke vagy MPI_ANY_TAG.

• comm [in]
  MPI communicator handle.

• message [out]
  A visszatéréskor az egyező üzenetre mutató mutatót tartalmaz.

• status [out]
  Visszatéréskor egy olyan MPI_Status struktúrára mutató mutatót tartalmaz, amelyben az üzenetre vonatkozó információk vannak tárolva.

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_MPROBE(SOURCE, TAG, COMM, MESSAGE, STATUS, IERROR)
          INTEGER SOURCE, TAG, COMM, MESSAGE, STATUS(MPI_STATUS_SIZE), IERROR

Megjegyzések

Ez a függvény úgy viselkedik, mint MPI_Improbe azzal a kivétellel, hogy ez egy blokkoló hívás, amely csak egyező üzenet megtalálása után ad vissza.

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_Improbe

MPI_Recv

MPI_Imrecv