共用方式為

MPI_Win_attach函式

  • 發行項

附加本機記憶體區域，以在指定的視窗中進行遠端訪問。

語法

int MPIAPI MPI_Win_attach(
   MPI_Win  win,
   void*    base,
   MPI_Aint size
);

參數

  • win [in]
    Window 物件。

  • base [in]
    要附加之內存的初始位址。

  • size [in]
    要以位元組為單位附加的記憶體大小。

傳回值

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

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

Fortran

    MPI_WIN_ATTACH(WIN, BASE, SIZE, IERROR)
        INTEGER WIN, IERROR
        <type> BASE(*)
        INTEGER(KIND=MPI_ADDRESS_KIND) SIZE

備註

附加本機記憶體區域，從 基底 開始，供指定視窗內的遠端訪問使用。 指定的記憶體區域不得包含已經附加至視窗 win 的任何元件，也就是說，在同一個視窗中同時附加重迭的記憶體是錯誤的。 自變數 win 必須是使用 MPI_Win_create_dynamic 建立的視窗。 附加至視窗的本機記憶體區域是由大小位元組所組成，從位址基底開始。 在 C 中，基底是記憶體區域的起始位址。 在 Fortran 中，用戶可以傳遞記憶體區域的第一個專案或整個數位，這必須是 連續的。 多個 (但非重疊) 記憶體區域可能會附加至相同的視窗。

規格需求

產品

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 函式