MPI_Irsend函式

發行項
01/16/2024

起始就緒模式傳送作業，並傳回代表通訊作業的要求句柄。

語法

int MPIAPI MPI_Irsend(
  _In_opt_ void         *buf,
           int          count,
           MPI_Datatype datatype,
           int          dest,
           int          tag,
           MPI_Comm     comm,
  _Out_    MPI_Request  *request
);

參數

buf [in， optional]
緩衝區的指標，其中包含要傳送的數據。緩衝區是由 數據類型 句柄所指示之MPI_Datatype對象的後續元素所組成。訊息長度是以元素數目來指定，而不是位元元數目。在通訊作業完成之前，呼叫端不應該修改傳送緩衝區的任何部分。
計數
緩衝區陣列中的項目數目。如果 count 為零，則訊息的數據部分是空的。
datatype
句柄，表示緩衝區中項目的數據型別。
dest
communicator comm 參數中目的地進程的排名。
標記
用來區分不同類型的訊息的訊息標記。
通訊
通訊器的句柄。
要求 [out]
傳回時，表示通訊作業之句柄的指標。

傳回值

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

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

Fortran

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

備註

此函式可以在從傳送緩衝區複製訊息之前傳回。此函式是本機函式，它會立即傳回，而不論其他進程的狀態為何。如需就緒通訊模式的描述，請參閱 MPI_Rsend 函式的備註。

規格需求

產品	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