MPI_Bcast işlevi

Bir grubun bir üyesinden gelen verileri grubun tüm üyelerine yayınlar.

Söz dizimi

int MPIAPI MPI_Bcast(
  _Inout_  void        *buffer,
  _In_    int          count,
  _In_    MPI_Datatype datatype,
  _In_    int          root,
  _In_    MPI_Comm     comm
);

Parametreler

• buffer [in, out]
  Veri arabelleği işaretçisi. Kök parametresi tarafından belirtilen işlemde arabellek yayınlanacak verileri içerir. comm parametresi tarafından belirtilen communicator'daki diğer tüm işlemlerde arabellek, kök işlem tarafından yayınlanan verileri alır.

• count [in]
  Arabellekteki veri öğelerinin sayısı. count parametresi sıfırsa, iletinin veri bölümü boş olur.

• veri türü [in]
  Gönderme arabelleğindeki öğelerin MPI veri türü.

• root [in]
  Verileri gönderen işlemin sırası.

• comm [in]
  MPI_Comm iletişimci tutamacı.

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_BCAST(BUFFER, COUNT, DATATYPE, ROOT, COMM, IERROR)
        <type> BUFFER(*)  
        INTEGER COUNT, DATATYPE, ROOT, COMM, IERROR

Açıklamalar

Her işlemdeki count ve veri türü parametreleri tarafından belirtilen tür imzası, kökte tür imzasına eşit olmalıdır. Bu gereksinim, gönderilen veri miktarının her işlemle kök arasında çift yönlü olarak alınan miktara eşit olması gerektiğini gösterir. MPI_Bcast ve diğer tüm veri taşıma kolektif yordamları bu kısıtlamayı yapar. Gönderen ve alıcı arasındaki ayrı tür eşlemelerine hala izin verilir.

comm parametresi bir intracommunicator'a başvuruda bulunuyorsa, MPI_Bcast işlevi belirtilen işlemden kendisini içeren grubun tüm işlemlerine bir ileti yayınlar. Aynı parametreleri kullanan grubun tüm üyeleri tarafından çağrılır. Dönüşte kök arabellek içeriği diğer tüm işlemlere kopyalanır.

comm parametresi bir intercommunicator'a başvuruda bulunursa, çağrı intercommunicator içindeki tüm işlemleri içerir, ancak kök işlemi tanımlayan bir grup olan A grubuyla birlikte. Diğer gruptaki tüm işlemler (grup B) kök parametrede aynı değeri, yani A grubundaki kök işlemin derecesini ayarlar. Kök işlem, kök parametresinde MPI_ROOT değerini ayarlar. A grubundaki diğer tüm işlemler kök parametrede MPI_PROC_NULL değerini ayarlar. Veriler kök işlemden B grubundaki tüm işlemlere yayınlanır. B grubundaki işlemlerin arabellek parametreleri, kök işlemin arabellek parametresiyle tutarlı olmalıdır.

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 Kolektif İşlevleri

MPI_Datatype