funktionen MPI_Mprobe

Artikel
01/16/2024

Blockerar avsökningar för ett meddelande. Tillhandahåller en mekanism för att ta emot det specifika meddelandet som matchades oavsett mellanliggande avsöknings-/mottagningsåtgärder. Det matchade meddelandet placeras i kö utanför mottagarkön, vilket ger programmet möjlighet att bestämma hur meddelandet ska tas emot baserat på den information som returneras av matchande avsökningsåtgärd. Det matchade meddelandet tas sedan emot med hjälp av funktionen MPI_Mrecv eller MPI_Imrecv .

Syntax

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

Parametrar

källa [in]
Källrankning eller MPI_ANY_SOURCE.
tag [in]
Meddelandetagg eller MPI_ANY_TAG.
comm [in]
MPI-kommunikationshandtag.
message [out]
Vid retur innehåller en pekare till det matchade meddelandet.
status [out]
Vid retur innehåller en pekare till en MPI_Status struktur där information om meddelandet lagras.

Returvärde

Returnerar MPI_SUCCESS vid lyckat resultat. Annars är returvärdet en felkod.

I Fortran lagras returvärdet i parametern IERROR .

Fortran

    MPI_MPROBE(SOURCE, TAG, COMM, MESSAGE, STATUS, IERROR)
          INTEGER SOURCE, TAG, COMM, MESSAGE, STATUS(MPI_STATUS_SIZE), IERROR

Kommentarer

Den här funktionen fungerar som MPI_Improbe förutom att det är ett blockerande anrop som bara returneras när ett matchande meddelande har hittats.