MPI_Init_thread الدالة

تهيئة بيئة تنفيذ عملية MPI الاستدعاء للتنفيذ المترابط.

بناء الجملة

int MPIAPI MPI_Init_thread(
  _In_opt_ int                        *argc,
           _In_opt_count_(*argc) char ***argv,
  _In_     int                        required,
  _Out_    int                        *provided
);

المعلمات

• argc [in, optional]
  مؤشر إلى عدد وسيطات البرنامج. يمكن أن تكون هذه القيمة NULL.

• argv [اختياري]
  مؤشر إلى قائمة الوسيطات للبرنامج. يمكن أن تكون هذه القيمة NULL.

• مطلوب [in]
  مستوى دعم مؤشر الترابط المطلوب. قد تستخدم عمليات MPI المتعددة في نفس المهمة قيما مختلفة.

  MPI_THREAD_SINGLE	سيتم تنفيذ مؤشر ترابط واحد فقط في البرنامج.
  MPI_THREAD_FUNNELED	قد تحتوي العملية على مؤشرات ترابط متعددة، ولكن مؤشر الترابط الذي يسمى MPI_Init_thread هو الوحيد الذي يقوم باستدعاءات دالة MPI.
  MPI_THREAD_SERIALIZED	قد تحتوي العملية على مؤشرات ترابط متعددة، وقد تقوم جميع مؤشرات الترابط هذه بإجراء استدعاءات دالة MPI، ولكن واحدة فقط في كل مرة.
  MPI_THREAD_MULTIPLE	قد تستدعي مؤشرات ترابط التطبيقات المتعددة وظائف MPI دون قيود. هذه القيمة مدعومة حاليا فقط على MS-MPI V6 الذي يعمل على Windows Server 2012 وWindows Server 2012 R2 Windows 8 Windows 8.1.

   

• المقدمة [خارج]
  مستوى دعم مؤشر الترابط المقدم. ستكون القيمة التي تم إرجاعها من الجدول أعلاه.

   

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

MPI_SUCCESS إذا كانت الدالة ترجع بنجاح. رموز الخطأ الأخرى إذا فشل الاستدعاء لأسباب أخرى (مثل الوسيطات غير الصالحة).

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

Fortran

    MPI_INIT_THREAD(REQUIRED, PROVIDED, IERROR)
        INTEGER REQUIRED, PROVIDED, IERROR

الملاحظات

يجب استدعاء هذه الدالة بواسطة مؤشر ترابط واحد فقط. سيعرف مؤشر الترابط هذا باسم "مؤشر الترابط الرئيسي" ويجب أن يكون نفس مؤشر الترابط لاستدعاء MPI_Finalize.

لا يقبل ربط Fortran MPI_Init_thread معلمات ARGC و ARGV.

المتطلبات

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

MPI_Init