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
);

パラメーター

• source [in]
  ソースランクまたは MPI_ANY_SOURCE。

• tag [in]
  メッセージ タグまたは MPI_ANY_TAG。

• comm [in]
  MPI コミュニケーター ハンドル。

• message [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と同様に動作します。

要件

こちらもご覧ください

MPI ポイント間関数

MPI_Improbe

MPI_Recv

MPI_Imrecv