função MPI_Comm_free
Liberta um comunicador atribuído às funções MPI_Comm_dup, MPI_Comm_create ou MPI_Comm_split .
Sintaxe
int MPIAPI MPI_Comm_free(
_Inout_ MPI_Comm *comm
);
Parâmetros
-
vírgula
O ponteiro para uma alça de comunicador para libertar.
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_FREE(COMM,IERROR)
INTEGER COMM, IERROR
Observações
Esta operação coletiva marca o objeto de comunicação para a desalocada. A alça está definida para MPI_COMM_NULL. As operações pendentes que utilizam este comunicador são concluídas normalmente. O objeto não é desalocado até que não existam referências ativas ao mesmo.
Esta função aplica-se tanto aos intracomuntores como aos intercomunicadores.
As funções de chamada de retorno de eliminação para todos os atributos em cache são chamadas por ordem indeterminada.
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 |