共用方式為

MPI_Intercomm_create函式

  • 發行項

從兩個內部通訊器建立 intercommuncator。

語法

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

參數

  • local_comm
    本機 (內部) 通訊器。

  • local_leader
    領導者 (local_comm 的排名通常為0) 。

  • peer_comm
    用於在其他通訊器中指定進程之間進行通訊的 Communicator。 只有在具有排名local_leader的local_comm程式中才重要。

  • remote_leader
    遠端領導者 (peer_comm 的排名通常為 0) 。

  • 標記
    用於建構 intercommunicator 的訊息標記;如果要建立多個 MPI_Intercomm_create ，則應該更精確地使用不同的標籤 (，確保本機和遠端領導者針對每個 MPI_Intercomm_create) 使用不同的標記。

  • newintercomm [out]
    已建立 intercommunicator。

傳回值

傳回成功 時MPI_SUCCESS 。 否則，傳回值是錯誤碼。

在 Fortran 中，傳回值會儲存在 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

規格需求

產品

HPC Pack 2012 MS-MPI 可轉散發套件、HPC Pack 2008 R2 MS-MPI 可轉散發套件、HPC Pack 2008 MS-MPI 可轉散發套件或 HPC Pack 2008 用戶端公用程式

標頭

 Mpi.h;Mpif.h

媒體櫃

 Msmpi.lib

DLL

 Msmpi.dll

另請參閱

MPI Communicator 函式