共用方式為

MPI_Rget函式

  • 發行項

要求型 RMA 取得作業。

語法

int MPIAPI MPI_Rget(
  _Out_ void         *origin_addr,
        int          origin_count,
        MPI_Datatype origin_datatype,
        int          target_rank,
        MPI_Aint     target_disp,
        int          target_count,
        MPI_Datatype datatype,
        MPI_Win      win,
  _Out_ MPI_Request  *request
);

參數

  • origin_addr [out]
    要在其中接收數據的緩衝區位址。

  • origin_count
    源緩衝區中的項目數目。

  • origin_datatype
    源緩衝區中每個專案的數據類型。

  • target_rank
    目標排名。

  • target_disp
    從視窗開始到目標緩衝區開頭的位移。

  • target_count
    目標緩衝區中的項目數目。

  • datatype
    目標緩衝區中每個專案的數據類型。

  • win
    用於通訊的 Window 物件。

  • 要求 [out]
    RMA 要求。

傳回值

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

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

Fortran

    MPI_RGET(ORIGIN_ADDR, ORIGIN_COUNT, ORIGIN_DATATYPE, TARGET_RANK,
                TARGET_DISP, TARGET_COUNT, TARGET_DATATYPE, WIN, REQUEST, IERROR)
        <type> ORIGIN_ADDR(*)
        INTEGER(KIND=MPI_ADDRESS_KIND) TARGET_DISP
        INTEGER ORIGIN_COUNT, ORIGIN_DATATYPE, TARGET_RANK, TARGET_COUNT, TARGET_DATATYPE, WIN, REQUEST, IERROR

備註

MPI_Rget 類似於 MPI_Get，不同之處在於它會配置通訊要求物件，並將它與要求句柄產生關聯， (可用來等候或測試完成的自變數 要求) 。 完成 MPI_Rget 作業表示源緩衝區中有數據可用。 如果 origin_addr 指向附加至視窗的記憶體，則此視窗的私人復本中會變成可用的數據。

規格需求

產品

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 One-Sided Communications 函式