MPI_Comm_free functie
Hiermee maakt u een communicator vrij die is toegewezen met de functies MPI_Comm_dup, MPI_Comm_create of MPI_Comm_split .
Syntaxis
int MPIAPI MPI_Comm_free(
_Inout_ MPI_Comm *comm
);
Parameters
-
Comm
De aanwijzer naar een communicator-ingang om vrij te maken.
Retourwaarde
Retourneert MPI_SUCCESS bij succes. Anders is de retourwaarde een foutcode.
In Fortran wordt de retourwaarde opgeslagen in de parameter IERROR .
Fortran
MPI_COMM_FREE(COMM,IERROR)
INTEGER COMM, IERROR
Opmerkingen
Deze collectieve bewerking markeert het communicatieobject voor deallocatie. De greep is ingesteld op MPI_COMM_NULL. Alle in behandeling zijnde bewerkingen die gebruikmaken van deze communicator, worden normaal voltooid. De toewijzing van het object wordt pas ongedaan gemaakt als er geen actieve verwijzingen naar het object zijn.
Deze functie is van toepassing op zowel intracommunicators als intercommunicators.
De functies voor het verwijderen van callback voor alle kenmerken in de cache worden in een onbepaalde volgorde aangeroepen.
Vereisten
Product |
HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package of HPC Pack 2008 Client Utilities |
Header |
Mpi.h; Mpif.h |
Bibliotheek |
Msmpi.lib |
DLL |
Msmpi.dll |