Dela via


funktionen MPI_Comm_free

Frigör en kommunikatör som allokeras med funktionerna MPI_Comm_dup, MPI_Comm_create eller MPI_Comm_split .

Syntax

int MPIAPI MPI_Comm_free(
   _Inout_ MPI_Comm *comm
);

Parametrar

  • Comm
    Pekaren till ett communicator-handtag till kostnadsfritt.

Returvärde

Returnerar MPI_SUCCESS vid lyckat resultat. Annars är returvärdet en felkod.

I Fortran lagras returvärdet i parametern IERROR .

Fortran

    MPI_COMM_FREE(COMM,IERROR)
        INTEGER COMM, IERROR

Kommentarer

Den här kollektiva åtgärden markerar kommunikationsobjektet för frigöring. Handtaget är inställt på MPI_COMM_NULL. Alla väntande åtgärder som använder den här kommunikationsappen slutförs normalt. Objektet frigörs inte förrän det inte finns några aktiva referenser till det.

Den här funktionen gäller både intracommunicators och intercommunicators.

Återanropsfunktionerna för borttagning för alla cachelagrade attribut anropas i obestämd ordning.

Krav

Produkt

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

Huvud

Mpi.h; Mpif.h

Bibliotek

Msmpi.lib

DLL

Msmpi.dll

Se även

MPI Communicator Functions

MPI_Comm_create

MPI_Comm_split

MPI_Comm_dup