共用方式為

MPI_Win_shared_query 函式

  • 發行項

查詢使用 MPI_Win_allocate_shared 建立之遠端記憶體區段的進程本機位址。

語法

int MPIAPI MPI_Win_shared_query(
        MPI_Win  *win
        int      rank,
  _Out_ MPI_Aint *size,
  _Out_ int      *disp_unit,
  _Out_ void     *baseptr
);

參數

  • win [in]
    共用記憶體視窗物件。

  • rank
    在視窗 win 群組中排名， (非負整數) 或 MPI_PROC_NULL。

  • size [out]
    視窗區段的大小。

  • disp_unit [out]
    位移的本機單位大小，以位元組為單位。

  • baseptr [out]
    視窗區段的載入/存放區存取位址。

傳回值

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

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

Fortran

    MPI_WIN_SHARED_QUERY(WIN, RANK, SIZE, DISP_UNIT, BASEPTR, IERROR)
        INTEGER WIN, RANK, DISP_UNIT, IERROR
        INTEGER (KIND=MPI_ADDRESS_KIND) SIZE, BASEPTR

備註

此函式會查詢使用 MPI_Win_allocate_shared 建立之遠端記憶體區段的進程本機位址。 此函式可以針對不同進程上的相同實體記憶體，傳回不同的進程本機位址。

規格需求

產品

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