funktionen MPI_Comm_free
Frigör en kommunikatör som allokeras med funktionerna MPI_Comm_dup, MPI_Comm_create eller MPI_Comm_split .
Syntax
int MPIAPI MPI_Comm_free(
_Inout_ MPI_Comm *comm
);
Parametrar
-
Comm
Pekaren till ett communicator-handtag till kostnadsfritt.
Returvärde
Returnerar MPI_SUCCESS vid lyckat resultat. Annars är returvärdet en felkod.
I Fortran lagras returvärdet i parametern IERROR .
Fortran
MPI_COMM_FREE(COMM,IERROR)
INTEGER COMM, IERROR
Kommentarer
Den här kollektiva åtgärden markerar kommunikationsobjektet för frigöring. Handtaget är inställt på MPI_COMM_NULL. Alla väntande åtgärder som använder den här kommunikationsappen slutförs normalt. Objektet frigörs inte förrän det inte finns några aktiva referenser till det.
Den här funktionen gäller både intracommunicators och intercommunicators.
Återanropsfunktionerna för borttagning för alla cachelagrade attribut anropas i obestämd ordning.
Krav
Produkt |
HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package eller HPC Pack 2008 Client Utilities |
Huvud |
Mpi.h; Mpif.h |
Bibliotek |
Msmpi.lib |
DLL |
Msmpi.dll |