Sdílet prostřednictvím


MPI_Comm_free funkce

Uvolní komunikátor, který je přidělen pomocí funkcí MPI_Comm_dup, MPI_Comm_create nebo MPI_Comm_split .

Syntaxe

int MPIAPI MPI_Comm_free(
   _Inout_ MPI_Comm *comm
);

Parametry

  • Komunikace
    Ukazatel na popisovač komunikátoru se uvolní.

Vrácená hodnota

Vrátí MPI_SUCCESS při úspěchu. V opačném případě je návratovou hodnotou kód chyby.

V nástroji Fortran je vrácená hodnota uložena v parametru IERROR .

Fortran

    MPI_COMM_FREE(COMM,IERROR)
        INTEGER COMM, IERROR

Poznámky

Tato kolektivní operace označí komunikační objekt pro uvolnění polohy. Popisovač je nastavený na MPI_COMM_NULL. Všechny čekající operace, které používají tento komunikátor, se dokončí normálně. Objekt není uvolněn, dokud na něj nejsou žádné aktivní odkazy.

Tato funkce se vztahuje jak na intrakomunikátory, tak na mezikomunikátory.

Funkce zpětného volání odstranění pro všechny atributy uložené v mezipaměti jsou volány v neurčitých pořadích.

Požadavky

Produkt

HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package nebo HPC Pack 2008 Client Utilities

Hlavička

Mpi.h; Mpif.h

Knihovna

Msmpi.lib

DLL

Msmpi.dll

Viz také

Funkce mpi communicatoru

MPI_Comm_create

MPI_Comm_split

MPI_Comm_dup