الدالة MPI_Comm_free

تحرير موصل يتم تخصيصه مع وظائف MPI_Comm_dup أو MPI_Comm_create أو MPI_Comm_split .

بناء الجملة

int MPIAPI MPI_Comm_free(
   _Inout_ MPI_Comm *comm
);

المعلمات

• الاتصالات
  المؤشر إلى مقبض موصل مجانا.

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

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

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

Fortran

    MPI_COMM_FREE(COMM,IERROR)
        INTEGER COMM, IERROR

الملاحظات

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

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

يتم استدعاء دالات حذف رد الاتصال لكافة السمات المخزنة مؤقتا بترتيب غير محدد.

المتطلبات

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

MPI_Comm_create

MPI_Comm_split

MPI_Comm_dup