MPI_Comm_free, fonction
Libère un communicateur qui est alloué avec les fonctions MPI_Comm_dup, MPI_Comm_create ou MPI_Comm_split .
Syntaxe
int MPIAPI MPI_Comm_free(
_Inout_ MPI_Comm *comm
);
Paramètres
-
comm
Pointeur vers un handle de communicateur vers libre.
Valeur retournée
Retourne MPI_SUCCESS en cas de réussite. Sinon, la valeur de retour est un code d’erreur.
Dans Fortran, la valeur de retour est stockée dans le paramètre IERROR .
Fortran
MPI_COMM_FREE(COMM,IERROR)
INTEGER COMM, IERROR
Remarques
Cette opération collective marque l’objet de communication pour la désallocation. Le handle est défini sur MPI_COMM_NULL. Toutes les opérations en attente qui utilisent ce communicateur se terminent normalement. L’objet n’est pas libéré tant qu’il n’y a pas de référence active à celui-ci.
Cette fonction s’applique aux intracommunicateurs et aux intercommunicateurs.
Les fonctions de rappel de suppression pour tous les attributs mis en cache sont appelées dans un ordre indéterminé.
Configuration requise
Produit |
Package redistribuable MS-MPI HPC Pack 2012, package redistribuable HPC Pack 2008 R2 MS-MPI, package redistribuable MS-MPI HPC Pack 2008 ou utilitaires clients HPC Pack 2008 |
En-tête |
Mpi.h ; Mpif.h |
Bibliothèque |
Msmpi.lib |
DLL |
Msmpi.dll |