funzione MPI_Comm_free
Libera un comunicatore allocato con le funzioni MPI_Comm_dup, MPI_Comm_create o MPI_Comm_split.
Sintassi
int MPIAPI MPI_Comm_free(
_Inout_ MPI_Comm *comm
);
Parametri
-
Comm
Puntatore a un handle di comunicatore per liberare.
Valore restituito
Restituisce MPI_SUCCESS sull'esito positivo. In caso contrario, il valore restituito è un codice di errore.
In Fortran il valore restituito viene archiviato nel parametro IERROR .
Fortran
MPI_COMM_FREE(COMM,IERROR)
INTEGER COMM, IERROR
Commenti
Questa operazione collettiva contrassegna l'oggetto di comunicazione per deallocazione. L'handle è impostato su MPI_COMM_NULL. Tutte le operazioni in sospeso che usano questo comunicatore terminano normalmente. L'oggetto non viene deallocato finché non sono presenti riferimenti attivi.
Questa funzione si applica sia ai intracommunicator che ai intercommunicatori.
Le funzioni di callback di eliminazione per tutti gli attributi memorizzati nella cache vengono chiamate in un ordine indeterminato.
Requisiti
Prodotto |
Pacchetto ridistribuibile HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package o HPC Pack 2008 Utilità client |
Intestazione |
Mpi.h; Mpif.h |
Libreria |
Msmpi.lib |
DLL |
Msmpi.dll |