MPI_Comm_dup işlevi

Mevcut bir iletişimciyi ilişkili anahtar değerleriyle çoğaltır. Her anahtar değeri için ilgili copy geri çağırma işlevi, yeni communicator'da bu anahtarla ilişkili öznitelik değerini belirler. Kopyalama geri çağırması, örneğin özniteliği yeni communicator'dan silebilir.

Söz dizimi

int MPIAPI MPI_Comm_dup(
        MPI_Comm comm,
  _Out_ MPI_Comm *newcomm
);

Parametreler

• Comm
  Çoğaltacak iletişimci.

• newcomm [out]
  Dönüşte, yeni bir iletişimcinin tanıtıcısını içerir. Yeni communicator aynı grup veya gruplara ve kaynaktan kopyalanmış önbelleğe alınmış bilgilere sahiptir, ancak yeni bağlam bilgileri içerir.

Döndürülen değer

Başarılı MPI_SUCCESS döndürür. Aksi takdirde, dönüş değeri bir hata kodudur.

Fortran'da dönüş değeri IERROR parametresinde depolanır.

Fortran

    MPI_COMM_DUP(COMM,NEWCOMM,IERROR)
        INTEGER COMM, NEWCOMM, IERROR

Açıklamalar

Bu işlev, özgün communicator ile aynı özelliklere sahip yinelenen bir iletişim alanı oluşturur. Bu, tüm öznitelikleri ve topolojileri içerir. Bu işlev, kaynak iletişimciyi içeren bekleyen noktadan noktaya iletişimler olsa bile geçerlidir.

Bir kullanıcı paralel işlemin başlangıcında MPI_Comm_dup işlevini çağırabilir ve daha sonra MPI_Comm_free işlevini kullanarak yinelenen iletişimciyi serbest bırakın. Diğer iletişimci yönetimi modelleri de mümkündür.

Bu işlev hem intracommunicators hem de intercommunicators için geçerlidir.

Gereksinimler

Ürün	HPC Pack 2012 MS-MPI Yeniden Dağıtılabilir Paketi, HPC Pack 2008 R2 MS-MPI Yeniden Dağıtılabilir Paketi, HPC Pack 2008 MS-MPI Yeniden Dağıtılabilir Paketi veya HPC Pack 2008 İstemci Yardımcı Programları
Üst bilgi	Mpi.h; Mpif.h
Kitaplık	Msmpi.lib
DLL	Msmpi.dll

Ayrıca bkz.

MPI Communicator İşlevleri