Delen via


MPI_Intercomm_create functie

Hiermee maakt u een intercommuncator van twee intracommunicators.

Syntaxis

int MPIAPI MPI_Intercomm_create(
        MPI_Comm local_comm,
        int      local_leader,
        MPI_Comm peer_comm,
        int      remote_leader,
        int      tag,
  _Out_ MPI_Comm *newintercomm
);

Parameters

  • local_comm
    Lokale (intra)communicator.

  • local_leader
    Rangschikking in local_comm van leider (vaak 0).

  • peer_comm
    Communicator wordt gebruikt om te communiceren tussen een aangewezen proces in de andere communicator. Alleen significant tijdens het proces in local_comm met rang local_leader.

  • remote_leader
    Rangschikking in peer_comm van externe leider (vaak 0).

  • Tag
    Berichttag die moet worden gebruikt bij het samenstellen van een intercommunicator; als er meerdere MPI_Intercomm_create worden gemaakt, moeten ze verschillende tags gebruiken (om precies te zijn: zorg ervoor dat de lokale en externe leiders verschillende tags gebruiken voor elke MPI_Intercomm_create).

  • newintercomm [uit]
    Er is een intercommunicator gemaakt.

Retourwaarde

Retourneert MPI_SUCCESS bij succes. Anders is de retourwaarde een foutcode.

In Fortran wordt de retourwaarde opgeslagen in de parameter IERROR .

Fortran

    MPI_INTERCOMM_CREATE(LOCAL_COMM, LOCAL_LEADER, PEER_COMM, REMOTE_LEADER, 
            TAG, NEWINTERCOMM, IERROR)
        INTEGER LOCAL_COMM, LOCAL_LEADER, PEER_COMM, REMOTE_LEADER, TAG,
        NEWINTERCOMM, IERROR

Vereisten

Product

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

Header

Mpi.h; Mpif.h

Bibliotheek

Msmpi.lib

DLL

Msmpi.dll

Zie ook

MPI Communicator-functies