MPI_Comm_free-Funktion
Gibt einen Kommunikator frei, der den Funktionen MPI_Comm_dup, MPI_Comm_create oder MPI_Comm_split zugeordnet ist.
Syntax
int MPIAPI MPI_Comm_free(
_Inout_ MPI_Comm *comm
);
Parameter
-
comm
Der Zeiger auf ein Freisprechhandle.
Rückgabewert
Gibt MPI_SUCCESS nach Erfolg zurück. Andernfalls ist der Rückgabewert ein Fehlercode.
In Fortran wird der Rückgabewert im IERROR-Parameter gespeichert.
Fortran
MPI_COMM_FREE(COMM,IERROR)
INTEGER COMM, IERROR
Hinweise
Dieser Sammelvorgang markiert das Kommunikationsobjekt für die Deallocation. Der Handle ist auf MPI_COMM_NULL festgelegt. Alle ausstehenden Vorgänge, die diesen Kommunikator verwenden, werden normal abgeschlossen. Das Objekt wird erst dann zugeordnet, wenn keine aktiven Verweise darauf vorhanden sind.
Diese Funktion gilt sowohl für Intrakommunikations- als auch für Interkommunikationsvermittler.
Die Löschrückruffunktionen für alle zwischengespeicherten Attribute werden in einer unbestimmten Reihenfolge aufgerufen.
Anforderungen
Produkt |
HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package oder HPC Pack 2008 Client Utilities |
Header |
Mpi.h; Mpif.h |
Bibliothek |
Msmpi.lib |
DLL |
Msmpi.dll |