MPI_Intercomm_create, funkcja

Tworzy interpoluncator z dwóch wewnątrzkomunikatorów.

Składnia

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
);

Parametry

• local_comm
  Lokalny (wewnątrz)komunikator.

• local_leader
  Ranga w local_comm lidera (często 0).

• peer_comm
  Komunikator używany do komunikowania się między wyznaczonym procesem w innym komunikatorze. Istotne tylko w procesie w local_comm z local_leader rangi.

• remote_leader
  Ranga w peer_comm zdalnego lidera (często 0).

• Tag
  Tag komunikatu do użycia w konstruowaniu intercommunicator; jeśli są tworzone wiele MPI_Intercomm_create , powinny używać różnych tagów (dokładniej, upewnij się, że liderzy lokalni i zdalni używają różnych tagów dla każdego MPI_Intercomm_create).

• newintercomm [out]
  Utworzono interpolenicator.

Wartość zwracana

Zwraca MPI_SUCCESS po powodzeniu. W przeciwnym razie zwracana wartość jest kodem błędu.

W fortran wartość zwracana jest przechowywana w parametrze 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

Wymagania

Produkt	Pakiet redystrybucyjny HPC Pack 2012 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 R2 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 MS-MPI lub narzędzia klienckie HPC Pack 2008
Nagłówek	Mpi.h; Mpif.h
Biblioteka	Msmpi.lib
DLL	Msmpi.dll

Zobacz też

MPI Communicator Functions