MPI_Intercomm_create 函数

从两个内部通信器创建一个通信器。

语法

int MPIAPI MPI_Intercomm_create(
        MPI_Comm local_comm,
        int      local_leader,
        MPI_Comm peer_comm,
        int      remote_leader,
        int      tag,
  _Out_ MPI_Comm *newintercomm
);

参数

  • local_comm
    本地 () 通信器内部。

  • local_leader
    领导 (local_comm排名通常为 0) 。

  • peer_comm
    用于在其他通信器中的指定进程之间进行通信的 Communicator。 仅在具有排名 local_leader的local_comm 过程中 重要。

  • remote_leader
    远程领导者peer_comm (排名通常为 0) 。

  • 标签
    用于构造通信器的消息标记;如果要进行多个 MPI_Intercomm_create ,则应更准确地使用不同的标记 (,确保本地和远程领导者为每个 MPI_Intercomm_create) 使用不同的标记。

  • newintercomm [out]
    已创建互通信器。

返回值

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

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

Fortran

    MPI_INTERCOMM_CREATE(LOCAL_COMM, LOCAL_LEADER, PEER_COMM, REMOTE_LEADER, 
            TAG, NEWINTERCOMM, IERROR)
        INTEGER LOCAL_COMM, LOCAL_LEADER, PEER_COMM, REMOTE_LEADER, TAG,
        NEWINTERCOMM, IERROR

要求

产品

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 Communicator 函数