MPI_Bcast الدالة

بث البيانات من عضو واحد في مجموعة إلى جميع أعضاء المجموعة.

بناء الجملة

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

المعلمات

• المخزن المؤقت [داخل، خارج]
  المؤشر إلى المخزن المؤقت للبيانات. في العملية المحددة بواسطة المعلمة الجذر ، يحتوي المخزن المؤقت على البيانات التي سيتم بثها. في جميع العمليات الأخرى في communicator التي تم تحديدها بواسطة معلمة comm ، يتلقى المخزن المؤقت بث البيانات بواسطة العملية الجذر.

• العد [في]
  عدد عناصر البيانات في المخزن المؤقت. إذا كانت معلمة العد صفرا، يكون جزء البيانات من الرسالة فارغا.

• نوع البيانات [in]
  نوع بيانات MPI للعناصر في المخزن المؤقت لإرسال.

• الجذر [in]
  رتبة العملية التي ترسل البيانات.

• comm [in]
  مقبض MPI_Comm communicator.

القيمة المُرجعة

إرجاع MPI_SUCCESS عند النجاح. وإلا، فإن القيمة المرجعة هي رمز خطأ.

في Fortran، يتم تخزين القيمة المرجعة في المعلمة IERROR .

Fortran

    MPI_BCAST(BUFFER, COUNT, DATATYPE, ROOT, COMM, IERROR)
        <type> BUFFER(*)  
        INTEGER COUNT, DATATYPE, ROOT, COMM, IERROR

الملاحظات

يجب أن يكون توقيع النوع كما هو محدد بواسطة معلمات العد ونوع البيانات في كل عملية مساويا لتوقيع النوع في الجذر. يعني هذا المطلب أن كمية البيانات المرسلة يجب أن تكون مساوية للمقدار المستلم، والاقتران بين كل عملية والجذر. MPI_Bcast وجميع الإجراءات الجماعية الأخرى لحركة البيانات تجعل هذا التقييد. لا يزال يسمح بخرائط النوع المميزة بين المرسل والمتلقي.

إذا كانت معلمة comm تشير إلى أداة داخلية، فإن وظيفة MPI_Bcast تبث رسالة من العملية المحددة إلى جميع عمليات المجموعة التي تتضمن نفسها. يتم استدعاؤه من قبل جميع أعضاء المجموعة الذين يستخدمون نفس المعلمات. عند العودة، يتم نسخ محتوى المخزن المؤقت الجذر إلى جميع العمليات الأخرى.

إذا كانت معلمة comm تشير إلى متداخل، فإن الاستدعاء يتضمن جميع العمليات في التداخل، ولكن مع مجموعة واحدة، المجموعة A، التي تحدد عملية الجذر. تقوم جميع العمليات في المجموعة الأخرى، المجموعة ب، بتعيين نفس القيمة في معلمة الجذر ، أي ترتيب عملية الجذر في المجموعة A. تعين عملية الجذر القيمة MPI_ROOT في المعلمة الجذر . تعين جميع العمليات الأخرى في المجموعة A القيمة MPI_PROC_NULL في المعلمة الجذر . يتم بث البيانات من العملية الجذر إلى جميع العمليات في المجموعة B. يجب أن تكون معلمات المخزن المؤقت للعمليات في المجموعة B متسقة مع معلمة المخزن المؤقت لعملية الجذر.

المتطلبات

منتج	حزمة 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

MPI_Datatype