الدالة MPI_Cancel

إلغاء طلب اتصال.

بناء الجملة

int MPIAPI MPI_Cancel(
  _In_ MPI_Request *request
);

المعلمات

• طلب [in]
  طلب الاتصال.

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

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

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

Fortran

    MPI_CANCEL(REQUEST, IERROR)
        INTEGER REQUEST, IERROR

الملاحظات

الاستخدام المتوقع الأساسي MPI_Cancel هو في أنظمة التخزين المؤقت المتعدد، حيث يتم إجراء MPI_Irecvالمضاربة. عند اكتمال الحساب، قد تظل بعض طلبات التلقي هذه؛ يسمح استخدام MPI_Cancel للمستخدم بإلغاء هذه الطلبات غير الراضية.

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

المتطلبات

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