MPI_Win_create_keyval 函数

为 MPI 窗口对象创建属性键值。

语法

int MPIAPI MPI_Win_create_keyval(
  _In_     MPI_Win_copy_attr_function   *win_copy_attr_fn,
  _In_     MPI_Win_delete_attr_function *win_delete_attr_fn,
  _Out_    int                          *win_keyval,
  _In_opt_ void                         *extra_state
);

参数

  • win_copy_attr_fn [in]
    复制win_keyval的回调函数。

  • win_delete_attr_fn [in]
    删除 win_keyval的回调函数。

  • win_keyval [out]
    用于将来访问的键值。

  • extra_state [in, 可选]
    回调函数的额外状态。

返回值

返回成功 时MPI_SUCCESS 。 否则,返回值为错误代码。

在 Fortran 中,返回值存储在 IERROR 参数中。

Fortran

    MPI_WIN_CREATE_KEYVAL(WIN_COPY_ATTR_FN, WIN_DELETE_ATTR_FN, WIN_KEYVAL,
                EXTRA_STATE, IERROR)
        EXTERNAL WIN_COPY_ATTR_FN, WIN_DELETE_ATTR_FN
        INTEGER WIN_KEYVAL, IERROR
        INTEGER(KIND=MPI_ADDRESS_KIND) EXTRA_STATE

注解

默认的复制和删除函数可用。 这 4 种方式为:

  • MPI_WIN_NULL_COPY_FN - 空复制函数
  • MPI_WIN_NULL_DELETE_FN - 空删除函数
  • MPI_WIN_DUP_FN - 简单 dup 函数

要求

产品

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 缓存函数

MPI_Win_delete_attr_function

MPI_Win_copy_attr_function