Compartilhar via


função MPI_Comm_group

Recupera o grupo associado a um comunicador.

Sintaxe

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

Parâmetros

  • comm
    O comunicador no qual basear o grupo.

  • grupo [out]
    No retorno, contém o identificador para o grupo associado ao comunicador especificado.

Retornar valor

Retorna MPI_SUCCESS com êxito. Caso contrário, o valor retornado será um código de erro.

No Fortran, o valor retornado é armazenado no parâmetro IERROR .

Fortran

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

Comentários

Esta é uma operação local. Processos diferentes podem definir grupos distintos. Um processo pode definir um grupo que não se inclui.

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

Requisitos

Produto

Pacote Redistribuível do HPC Pack 2012 MS-MPI, Pacote Redistribuível HPC Pack 2008 R2 MS-MPI, Pacote Redistribuível do HPC Pack 2008 MS-MPI ou Utilitários de Cliente HPC Pack 2008

parâmetro

Mpi.h; Mpif.h

Biblioteca

Msmpi.lib

DLL

Msmpi.dll

Confira também

Funções de grupo de MPI