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_Send和MPI_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 |