Partilhar via


função MPI_Intercomm_create

Cria um intercomunicador a partir de dois intracomunicadores.

Sintaxe

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

Parâmetros

  • local_comm
    Comunicador local (intra).

  • local_leader
    Classificação em local_comm de líder (muitas vezes 0).

  • peer_comm
    Communicator utilizado para comunicar entre um processo designado no outro comunicador. Significativo apenas no processo em local_comm com local_leader de classificação.

  • remote_leader
    Classificação em peer_comm de líder remoto (muitas vezes 0).

  • etiqueta
    Etiqueta de mensagem a utilizar na construção de intercomunicador; Se estiverem a ser efetuadas várias MPI_Intercomm_create, devem utilizar etiquetas diferentes (mais precisamente, certifique-se de que os líderes locais e remotos estão a utilizar etiquetas diferentes para cada MPI_Intercomm_create).

  • newintercomm [out]
    Foi criado um intercomunicador.

Valor devolvido

Devolve MPI_SUCCESS com êxito. Caso contrário, o valor devolvido é um código de erro.

Em Fortran, o valor devolvido é armazenado no parâmetro 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

Requisitos

Produto

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

Cabeçalho

Mpi.h; Mpif.h

Biblioteca

Msmpi.lib

DLL

Msmpi.dll

Ver também

Funções do Communicator do MPI