MPI_Irecv函式

發行項
12/27/2023

起始接收作業，並傳回要求的通訊作業控制碼。

語法

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

參數

buf [in， optional]
緩衝區的指標，其中包含要傳送的資料。
計數
緩衝區陣列中的專案數目。如果訊息的資料部分是空的，請將 count 參數設定為 0。
datatype
緩衝區中專案的資料型別。
source
指定通訊器內傳送程式的排名。指定 MPI_ANY_SOURCE 常數，以指定任何來源都是可接受的。
標記
可用來區分不同類型的訊息的訊息標記。指定 MPI_ANY_TAG 常數，指出任何標籤都是可接受的。
通訊
通訊器的控制碼。
要求 [out]
傳回時，包含要求的通訊作業控制碼。

傳回值

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

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

Fortran

    MPI_IRECV(BUF, COUNT, DATATYPE, SOURCE, TAG, COMM, REQUEST, IERROR)
        <type> BUF(*)
        INTEGER COUNT, DATATYPE, SOURCE, TAG, COMM, REQUEST, 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