MPI_Mprobe, funkcja
Blokowanie sond dla komunikatu. Zapewnia mechanizm odbierania konkretnego komunikatu, który został dopasowany niezależnie od interweniowania operacji sondy/odbierania. Dopasowany komunikat jest odsunięty od kolejki odbierania, co daje aplikacji możliwość podjęcia decyzji o sposobie odbierania komunikatu na podstawie informacji zwracanych przez pasującą operację sondy. Dopasowany komunikat jest następnie odbierany przy użyciu funkcji MPI_Mrecv lub MPI_Imrecv .
Składnia
int MPIAPI MPI_Mprobe(
_In_ int source,
_In_ int tag,
_In_ MPI_Comm comm,
_Out_ MPI_Message *message,
_Out_ MPI_Status *status
);
Parametry
źródło [in]
Ranga źródłowa lub MPI_ANY_SOURCE.tag [in]
Tag wiadomości lub MPI_ANY_TAG.comm [in]
Uchwyt komunikatora MPI.komunikat [out]
Po powrocie zawiera wskaźnik do dopasowanego komunikatu.status [out]
Po powrocie zawiera wskaźnik do struktury MPI_Status , w której są przechowywane informacje o komunikacie.
Wartość zwracana
Zwraca MPI_SUCCESS powodzenia. W przeciwnym razie wartość zwracana jest kodem błędu.
W fortran wartość zwracana jest przechowywana w parametrze IERROR .
Fortran
MPI_MPROBE(SOURCE, TAG, COMM, MESSAGE, STATUS, IERROR)
INTEGER SOURCE, TAG, COMM, MESSAGE, STATUS(MPI_STATUS_SIZE), IERROR
Uwagi
Ta funkcja zachowuje się jak MPI_Improbe , z tą różnicą, że jest to wywołanie blokujące, które zwraca tylko po znalezieniu pasującego komunikatu.
Wymagania
Produkt |
Microsoft MPI v6 |
Nagłówek |
Mpi.h; Mpif.h |
Biblioteka |
Msmpi.lib |
DLL |
Msmpi.dll |