共用方式為

MPI_Mprobe 函式

  • 發行項

封鎖訊息的探查。 提供一種機制，可接收符合的特定訊息，不論探查/接收作業為何。 相符的訊息會從接收佇列解除佇列，讓應用程式有機會根據相符探查作業傳回的信息來決定接收訊息的方式。 接著會使用 MPI_Mrecv 或 MPI_Imrecv 函式來接收相符的訊息。

語法

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

參數

  • 來源 [in]
    來源排名或 MPI_ANY_SOURCE。

  • 標記 [in]
    訊息標記或 MPI_ANY_TAG。

  • comm [in]
    MPI communicator 句柄。

  • 訊息 [out]
    傳回時，包含相符訊息的指標。

  • status [out]
    傳回時，包含儲存訊息相關信息 之MPI_Status 結構的指標。

傳回值

傳回成功 時MPI_SUCCESS 。 否則，傳回值是錯誤碼。

在 Fortran 中，傳回值會儲存在 IERROR 參數中。

Fortran

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

備註

此函式的行為就像 MPI_Improbe ，不同之處在於它是只有在找到相符訊息之後才會傳回的封鎖呼叫。

規格需求

產品

Microsoft MPI v6

標頭

 Mpi.h;Mpif.h

媒體櫃

 Msmpi.lib

DLL

 Msmpi.dll

另請參閱

MPI 點對點函式

MPI_Improbe

MPI_Recv

MPI_Imrecv