共用方式為


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

另請參閱

MPI 點對點函式

MPI_Send

MPI_Bsend

MPI_Rsend

MPI_Recv