Freigeben über


MPI_Comm_group-Funktion

Ruft die Gruppe ab, die einem Kommunikator zugeordnet ist.

Syntax

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

Parameter

  • comm
    Der Kommunikator, auf dem die Gruppe basieren soll.

  • group [out]
    Enthält bei der Rückgabe das Handle für die Gruppe, die dem angegebenen Kommunikator zugeordnet ist.

Rückgabewert

Gibt MPI_SUCCESS nach Erfolg zurück. Andernfalls ist der Rückgabewert ein Fehlercode.

In Fortran wird der Rückgabewert im IERROR-Parameter gespeichert.

Fortran

    MPI_COMM_GROUP(COMM, GROUP, IERROR)
        INTEGER COMM, GROUP, IERROR

Hinweise

Dies ist ein lokaler Vorgang. Unterschiedliche Prozesse können unterschiedliche Gruppen definieren. Ein Prozess kann eine Gruppe definieren, die sich selbst nicht einschließt.

Die MPI-Implementierung bietet keinen Mechanismus, um eine Gruppe von Grund auf neu zu erstellen, sondern nur aus vorhandenen Gruppen. Die Basisgruppe, für die alle anderen Gruppen definiert sind, ist die Gruppe, die dem anfänglichen Kommunikator MPI_COMM_WORLD zugeordnet ist.

Anforderungen

Produkt

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

Header

Mpi.h; Mpif.h

Bibliothek

Msmpi.lib

DLL

Msmpi.dll

Weitere Informationen

MPI-Gruppenfunktionen