通过

MPI_Comm_copy_attr_function 函数

  • 项目

MPI_Comm_copy_attr_function 是应用程序定义的函数名称的占位符。

语法

int MPI_Comm_copy_attr_function(
           MPI_Comm oldcomm,
           int      comm_keyval,
  _In_opt_ void     *extra_state,
  _In_     void     *attribute_val_in,
  _Out_    void     *attribute_val_out,
  _Out_    int      *flag
);

参数

  • oldcomm
    原始通信器。

  • comm_keyval
    键值。

  • extra_state [in， 可选]
    额外状态。

  • attribute_val_in [in]
    源属性值。

  • attribute_val_out [out]
    目标属性值。

  • flag [out]
    如果 flag 的返回值为 0 或 FALSE，则会在重复的通信器中删除该属性。 否则， (标志 = 1 或 TRUE) ，则新属性值设置为 在 attribute_val_out 中返回的值。

返回值

函数在成功 时返回MPI_SUCCESS ，在失败时返回错误代码。

Fortran

    SUBROUTINE COMM_COPY_ATTR_FUNCTION(OLDCOMM, COMM_KEYVAL, EXTRA_STATE,
                ATTRIBUTE_VAL_IN, ATTRIBUTE_VAL_OUT, FLAG, IERROR)
        INTEGER OLDCOMM, COMM_KEYVAL, IERROR
        INTEGER(KIND=MPI_ADDRESS_KIND) EXTRA_STATE, ATTRIBUTE_VAL_IN,
            ATTRIBUTE_VAL_OUT
        LOGICAL FLAG

注解

当MPI_Comm_dup复制通信器时，将调用 comm_copy_attr_fn 函数。

要求

产品

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_Comm_create_keyval