MPI_Comm_get_parent 函数

返回此过程的父通信器。

语法

int MPIAPI MPI_Comm_get_parent(
  _Out_ MPI_Comm *parent
);

参数

  • 父级 [out]
    父通信器。

返回值

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

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

Fortran

    MPI_COMM_GET_PARENT(PARENT, IERROR)
        INTEGER PARENT, IERROR

注解

如果进程是使用 MPI_Comm_spawnMPI_Comm_spawn_multiple 启动的, MPI_Comm_get_parent 返回当前进程的父间通信器。 此父通信器是在 MPI_Init 内隐式创建的,并且是父级 中MPI_Comm_spawn 返回的同一对讲器。

如果未生成进程, MPI_Comm_get_parent 将返回 MPI_COMM_NULL

释放或断开连接父通信器后, MPI_Comm_get_parent 返回 MPI_COMM_NULL

要求

产品

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 进程管理功能