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 通信函数