通过

MPI_Comm_set_attr 函数

  • 项目

存储与键关联的属性值。

语法

int MPIAPI MPI_Comm_set_attr(
       MPI_Comm comm,
       int      comm_keyval,
  _In_ void     *attribute_val
);

参数

  • comm
    属性将附加到的 Communicator。

  • comm_keyval
    由 MPI_Comm_create_keyval 返回的键值。

  • attribute_val [in]
    特性值。

返回值

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

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

Fortran

    MPI_COMM_SET_ATTR(COMM, COMM_KEYVAL, ATTRIBUTE_VAL, IERROR)
        INTEGER COMM, COMM_KEYVAL, IERROR
        INTEGER(KIND=MPI_ADDRESS_KIND) ATTRIBUTE_VAL

注解

不能更改永久属性 MPI_TAG_UB、 MPI_HOST、 MPI_IO、 MPI_WTIME_IS_GLOBAL、 MPI_UNIVERSE_SIZE、 MPI_LASTUSEDCODE和 MPI_APPNUM 的值。

属性值的数据类型取决于使用的是 C、C++ 还是 Fortran。 在 C 和 C++ 中，属性值是 void 指针;在 Fortran 中，它是地址大小的整数。

如果已存在属性，则 (创建相应的键值时指定的 delete 函数，) 将调用。

要求

产品

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