Dela via


funktionen MPI_Comm_group

Hämtar den grupp som är associerad med en kommunikatör.

Syntax

int MPIAPI MPI_Comm_group(
        MPI_Comm  comm,
  _Out_ MPI_Group *group
);

Parametrar

  • Comm
    Den kommunikatör som gruppen ska baseras på.

  • group [out]
    Vid retur innehåller referensen till den grupp som är associerad med den angivna kommunikatören.

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_GROUP(COMM, GROUP, IERROR)
        INTEGER COMM, GROUP, IERROR

Kommentarer

Det här är en lokal åtgärd. Olika processer kan definiera distinkta grupper. En process kan definiera en grupp som inte innehåller sig själv.

MPI-implementeringen tillhandahåller ingen mekanism för att skapa en grupp från grunden, utan bara från befintliga grupper. Basgruppen, där alla andra grupper har definierats, är den grupp som är associerad med den första kommunikationsgruppen MPI_COMM_WORLD.

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-gruppfunktioner