Partilhar via


função MPI_Comm_group

Obtém o grupo associado a um comunicador.

Sintaxe

int MPIAPI MPI_Comm_group(
        MPI_Comm  comm,
  _Out_ MPI_Group *group
);

Parâmetros

  • vírgula
    O comunicador no qual pretende basear o grupo.

  • grupo [fora]
    Na devolução, contém a alça para o grupo que está associado ao comunicador especificado.

Valor devolvido

Devolve MPI_SUCCESS com êxito. Caso contrário, o valor devolvido é um código de erro.

Em Fortran, o valor devolvido é armazenado no parâmetro IERROR .

Fortran

    MPI_COMM_GROUP(COMM, GROUP, IERROR)
        INTEGER COMM, GROUP, IERROR

Observações

Esta é uma operação local. Diferentes processos podem definir grupos distintos. Um processo pode definir um grupo que não se inclui a si próprio.

A implementação do MPI não fornece um mecanismo para criar um grupo de raiz, mas apenas a partir de grupos existentes. O grupo base, no qual todos os outros grupos são definidos, é o grupo associado ao comunicador inicial MPI_COMM_WORLD.

Requisitos

Produto

HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package ou HPC Pack 2008 Client Utilities

Cabeçalho

Mpi.h; Mpif.h

Biblioteca

Msmpi.lib

DLL

Msmpi.dll

Ver também

Funções do Grupo MPI