MPI_Comm_free, funkcja
Zwalnia komunikator, który jest przydzielany z MPI_Comm_dup, MPI_Comm_create lub MPI_Comm_split funkcji.
Składnia
int MPIAPI MPI_Comm_free(
_Inout_ MPI_Comm *comm
);
Parametry
-
Comm
Wskaźnik do uchwytu komunikatora, aby uwolnić.
Wartość zwracana
Zwraca MPI_SUCCESS po powodzeniu. W przeciwnym razie zwracana wartość jest kodem błędu.
W fortran wartość zwracana jest przechowywana w parametrze IERROR .
Fortran
MPI_COMM_FREE(COMM,IERROR)
INTEGER COMM, IERROR
Uwagi
Ta zbiorcza operacja oznacza obiekt komunikacji dla alokacji transakcji. Uchwyt jest ustawiony na MPI_COMM_NULL. Wszystkie oczekujące operacje korzystające z tego komunikatora zakończą się normalnie. Obiekt nie zostanie cofnięty, dopóki nie ma do niego żadnych aktywnych odwołań.
Ta funkcja ma zastosowanie zarówno do wewnątrzpolenicatorów, jak i międzypolenicatorów.
Funkcje wywołania zwrotnego usuwania dla wszystkich buforowanych atrybutów są wywoływane w nieokreślonej kolejności.
Wymagania
Produkt |
Pakiet redystrybucyjny HPC Pack 2012 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 R2 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 MS-MPI lub narzędzia klienckie HPC Pack 2008 |
Nagłówek |
Mpi.h; Mpif.h |
Biblioteka |
Msmpi.lib |
DLL |
Msmpi.dll |