MPI_Ssend函式
執行同步模式傳送作業,並在可以安全地重複使用傳送緩衝區時傳回 。
語法
int MPIAPI MPI_Ssend(
_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_SSEND(BUF, COUNT, DATATYPE, DEST, TAG, COMM, IERROR)
<type> BUF(*)
INTEGER COUNT, DATATYPE, DEST, TAG, COMM, IERROR
備註
此函式為非本機函式。 成功完成傳送作業取決於相符接收函式的出現。
不論是否張貼相符的接收,都可以呼叫此函式。 不過,只有在張貼相符的接收,而且接收作業已開始接收訊息時,才會順利完成傳送函式。 因此,同步傳送完成不僅表示可以重複使用傳送緩衝區,也表示接收進程已開始執行相符的接收。
如果傳送和接收作業都是封鎖作業,則同步模式會提供同步通訊語意;在傳送和接收程式完成之前,不會在任一端完成通訊。
規格需求
產品 |
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 |