Compartilhar via

função MPI_Comm_free

  • Artigo

Libera um comunicador alocado com as funções MPI_Comm_dup, MPI_Comm_create ou MPI_Comm_split .

Sintaxe

int MPIAPI MPI_Comm_free(
   _Inout_ MPI_Comm *comm
);

Parâmetros

  • comm
    O ponteiro para um identificador de comunicador para liberar.

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_FREE(COMM,IERROR)
        INTEGER COMM, IERROR

Comentários

Essa operação coletiva marca o objeto de comunicação para desalocação. O identificador é definido como MPI_COMM_NULL. Todas as operações pendentes que usam esse comunicador são concluídas normalmente. O objeto não é desalocado até que não haja referências ativas a ele.

Essa função se aplica a intracommunicadores e intercomunizadores.

As funções de retorno de chamada de exclusão para todos os atributos armazenados em cache são chamadas em uma ordem indeterminado.

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

MPI Communicator Functions

MPI_Comm_create

MPI_Comm_split

MPI_Comm_dup