MPI_Mprobe funkce
Blokování testů pro zprávu Poskytuje mechanismus pro příjem konkrétní zprávy, která byla spárována bez ohledu na operace sondy/příjmu. Odpovídající zpráva se zruší ve frontě příjmu, což aplikaci dává možnost rozhodnout se, jak zprávu přijmout na základě informací vrácených odpovídající operací sondy. Odpovídající zpráva se pak obdrží pomocí funkce MPI_Mrecv nebo MPI_Imrecv .
Syntaxe
int MPIAPI MPI_Mprobe(
_In_ int source,
_In_ int tag,
_In_ MPI_Comm comm,
_Out_ MPI_Message *message,
_Out_ MPI_Status *status
);
Parametry
source [v]
Pořadí zdroje nebo MPI_ANY_SOURCE.tag [in]
Značka zprávy nebo MPI_ANY_TAG.comm [in]
Popisovač komunikátoru MPI.zpráva [out]
Při návratu obsahuje ukazatel na odpovídající zprávu.status [out]
Při vrácení obsahuje ukazatel na strukturu MPI_Status , kde jsou uloženy informace o zprávě.
Vrácená hodnota
Vrátí MPI_SUCCESS při úspěchu. V opačném případě je návratovou hodnotou kód chyby.
Ve Fortranu je vrácená hodnota uložena v parametru IERROR .
Fortran
MPI_MPROBE(SOURCE, TAG, COMM, MESSAGE, STATUS, IERROR)
INTEGER SOURCE, TAG, COMM, MESSAGE, STATUS(MPI_STATUS_SIZE), IERROR
Poznámky
Tato funkce se chová jako MPI_Improbe s tím rozdílem, že se jedná o blokující volání, které se vrátí až po nalezení odpovídající zprávy.
Požadavky
Produkt |
Microsoft MPI v6 |
Hlavička |
Mpi.h; Soubor Mpif.h |
Knihovna |
Msmpi.lib |
DLL |
Msmpi.dll |