دالة MPI_Comm_dup

تكرار موصل موجود بقيم المفاتيح المقترنة. لكل قيمة مفتاح، تحدد دالة رد اتصال النسخ المعنية قيمة السمة المقترنة بهذا المفتاح في الموصل الجديد. يمكن لنسخ رد الاتصال، على سبيل المثال، حذف السمة من الموصل الجديد.

بناء الجملة

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

المعلمات

• الاتصالات
  الموصل المراد تكراره.

• newcomm [out]
  عند العودة، يحتوي على مقبض إلى موصل جديد. يحتوي الموصل الجديد على نفس المجموعة أو المجموعات وأي معلومات مخزنة مؤقتا من المصدر، ولكنه يحتوي على معلومات سياق جديدة.

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

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

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

Fortran

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

الملاحظات

تنشئ هذه الدالة مساحة اتصال مكررة لها نفس خصائص الموصل الأصلي. يتضمن ذلك أي سمات وطوبولوجيا. هذه الدالة صالحة حتى إذا كانت هناك اتصالات معلقة من نقطة إلى نقطة تتضمن موصل المصدر.

يمكن للمستخدم استدعاء الدالة MPI_Comm_dup في بداية العملية المتوازية ثم تحرير المتصل المكرر لاحقا باستخدام الدالة MPI_Comm_free . نماذج أخرى لإدارة التواصل ممكنة أيضا.

تنطبق هذه الدالة على كل من الاتصالات الداخلية والترابطية.

المتطلبات

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