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

Zobacz też

Funkcje typu punkt-punkt MPI

MPI_Improbe

MPI_Recv

MPI_Imrecv