MPI_Comm_free függvény

Felszabadítja a MPI_Comm_dup, MPI_Comm_create vagy MPI_Comm_split függvényekkel lefoglalt kommunikátort.

Szintaxis

int MPIAPI MPI_Comm_free(
   _Inout_ MPI_Comm *comm
);

Paraméterek

• Comm
  A mutató egy kommunikátor fogópontjára, hogy szabad legyen.

Visszatérési érték

Sikeres MPI_SUCCESS ad vissza. Ellenkező esetben a visszatérési érték hibakód.

A Fortranban a visszatérési érték az IERROR paraméterben van tárolva.

Fortran

    MPI_COMM_FREE(COMM,IERROR)
        INTEGER COMM, IERROR

Megjegyzések

Ez a kollektív művelet megjelöli a felszabadításhoz használt kommunikációs objektumot. A fogópont értéke MPI_COMM_NULL. A kommunikátort használó függőben lévő műveletek a szokásos módon fejeződnek be. Az objektum nincs felszabadítva, amíg nincsenek aktív hivatkozások rá.

Ez a függvény az intrakommunikátorokra és az interkommunikátorokra is vonatkozik.

Az összes gyorsítótárazott attribútum törlési visszahívási függvényei határozatlan sorrendben vannak meghívva.

Követelmények

Termék	HPC Pack 2012 MS-MPI terjeszthető csomag, HPC Pack 2008 R2 MS-MPI terjeszthető csomag, HPC Pack 2008 MS-MPI újraterjeszthető csomag vagy HPC Pack 2008 ügyfél-segédprogramok
Fejléc	Mpi.h; Mpif.h
Kódtár	Msmpi.lib
DLL	Msmpi.dll

Lásd még

MPI Communicator-függvények

MPI_Comm_create

MPI_Comm_split

MPI_Comm_dup