共用方式為


MPI_Rsend函式

執行就緒模式傳送作業,並在可以安全地重複使用傳送緩衝區時傳回 。

語法

int MPIAPI MPI_Rsend(
  _In_opt_ void         *buf,
           int          count,
           MPI_Datatype datatype,
           int          dest,
           int          tag,
           MPI_Comm     comm
);

參數

  • buf [in, optional]
    緩衝區的指標,其中包含要傳送的資料。

  • 計數
    緩衝區中的項目數。 如果訊息的資料部分是空的,請將 count 參數設定為 0。

  • datatype
    緩衝區中專案的資料類型。

  • dest
    comm參數所指定之 communicator 內的目的地進程排名。

  • 標記
    可用來區分不同類型的訊息的訊息標籤。

  • 通訊
    通訊器的控制碼。

傳回值

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

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

Fortran

    MPI_RSEND(BUF, COUNT, DATATYPE, DEST, TAG, COMM, IERROR)
        <type> BUF(*)
        INTEGER COUNT, DATATYPE, DEST, TAG, COMM, IERROR

備註

此函式為非本機。 此函式會在可重複使用傳送緩衝區時立即傳回,且不取決於相符接收作業的狀態。 不過,整體傳送作業的成功完成取決於相符接收作業是否存在。

只有在已張貼相符的接收作業時,才能呼叫此函式。 否則,函式會傳回錯誤,且其結果未定義。 在某些系統上,這項需求可消除某些用於其他模式的交握,並可改善相較于標準或同步傳送作業的效能。

MPI_Rsend函式的語意與MPI_SendMPI_Ssend函式相同,但會通知系統已張貼相符的接收。 該資訊可以節省一些額外負荷。 因此,在正確的程式中,就緒傳送可能會由標準傳送取代,而不會影響效能以外的程式列為。

規格需求

產品

HPC Pack 2012 MS-MPI 可轉散發套件、HPC Pack 2008 R2 MS-MPI 可轉散發套件、HPC Pack 2008 MS-MPI 可轉散發套件或 HPC Pack 2008 用戶端公用程式

標頭

Mpi.h;Mpif.h

媒體櫃

Msmpi.lib

DLL

Msmpi.dll

另請參閱

MPI 點對點函式

MPI_Send

MPI_Bsend

MPI_Ssend

MPI_Recv