通过

MPI_Comm_get_attr 函数

  • 项目

按键检索属性值。

语法

int MPIAPI MPI_Comm_get_attr(
        MPI_Comm comm,
        int      comm_keyval,
  _Out_ void     *attribute_val,
  _Out_ int      *flag
);

参数

  • comm
    属性附加到的通信器。

  • comm_keyval
    键值。

  • attribute_val [out]
    属性值，除非 flag = false。

  • flag [out]
    如果提取了属性值，则为 True;如果没有任何属性与键关联，则为 false。

返回值

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

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

Fortran

    MPI_COMM_GET_ATTR(COMM, COMM_KEYVAL, ATTRIBUTE_VAL, FLAG, IERROR)
        INTEGER COMM, COMM_KEYVAL, IERROR
        INTEGER(KIND=MPI_ADDRESS_KIND) ATTRIBUTE_VAL
        LOGICAL FLAG

注解

属性必须从使用 MPI_Comm_set_attr 插入的相同语言中提取。 尽管 attribute_val 参数声明为 void 指针，但它实际上是 void 指针的地址。 有关更多详细信息，请参阅标准中的理由。

要求

产品

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