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 中,base 是内存区域的起始地址。 在 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 通信函数