MPI_Improbe függvény

Egy üzenet mintavétele nem blokkoló módon. Mechanizmust biztosít az adott üzenet fogadásához, függetlenül a mintavételi/fogadási műveletek beavatkozásától. A egyeztetett üzenet a fogadási üzenetsoron kívülre kerül, így az alkalmazás eldöntheti, hogyan fogadhatja az üzenetet a nem blokkoló egyező mintavételi művelet által visszaadott információk alapján. Ezután a rendszer a MPI_Mrecv vagy MPI_Imrecv függvénnyel fogadja a megfelelő üzenetet.

Szintaxis

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

Paraméterek

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

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

• comm [in]
  MPI communicator handle.

• flag [out]
  A visszaadott érték egy egész számra mutató mutatót tartalmaz, amely jelzi, hogy a megadott forrás, címke és comm megfelel-e. A nem nulla érték azt jelzi, hogy a paraméterek egyeznek.

• üzenet [kifelé]
  Visszatérés esetén a megfelelő üzenetre mutató mutatót tartalmaz.

• status [out]
  Visszatérés esetén egy olyan MPI_Status struktúrára mutató mutatót tartalmaz, amelyben az üzenetre vonatkozó információk tárolódnak.

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

Megjegyzések

Ez a függvénytrue (igaz) jelzőt = ad vissza, ha egy üzenet fogadható, és megegyezik a forrás, címke és comm argumentumok által megadott mintával. A hívás megegyezik azzal az üzenetsel, amelyet a program ugyanazon pontján végrehajtott MPI_Recv hívása fogadott volna, és ugyanazzal az értékkel tér vissza, amelyet a MPI_Recv visszaadott volna. Emellett az üzenetben egy fogópontot ad vissza a egyeztetett üzenethez. Ellenkező esetben a híváshamisjelzőt = ad vissza, és az állapotot és az üzenetet nem jelöli meg.

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_Mprobe

MPI_Recv

MPI_Imrecv