مشاركة عبر


MSMPI_Waitsome_interruptible الدالة

ينتظر حتى تنتهي عملية واحدة على الأقل من العمليات المقترنة بالمقابض النشطة في القائمة، أو تتم مقاطعة الاستدعاء بواسطة مؤشر ترابط آخر يستدعي MSMPI_Queuelock_acquire.

بناء الجملة

int MPIAPI MSMPI_Waitsome_interruptible(
        int                                         incount,
        _Inout_count_(incount) MPI_Request          array_of_requests[],
  _Out_ int                                         *outcount,
        _Out_cap_post_count_(incount,*outcount) int array_of_indices[],
        _Out_cap_post_count_(incount,*outcount) int array_of_statuses[]
);

المعلمات

  • عدد الحسابات
    عدد الطلبات في الصفيف array_of_requests.

  • array_of_requests
    صفيف مقابض الطلب للعمليات التي يجب انتظار الاكتمال عليها. إذا تم تخصيص مقبض طلب بواسطة دالة اتصال غير محظورة، فسيتم إلغاء تخصيصه، ويتم تعيين المقبض المقترن إلى MPI_REQUEST_NULL.

  • عدد الصادرات [خارج]
    عدد الطلبات المحددة في المعلمة array_of_requests المكتملة وعدد العناصر في الصفائف array_of_indicesarray_of_statuses .

    إذا لم يحتوي array_of_requests على مؤشرات نشطة، فترجع الدالة على الفور مع تعيين معلمة outcount إلى MPI_UNDEFINED.

    إذا تمت مقاطعة هذه الدالة قبل اكتمال أي طلبات، فسيرجع الاستدعاء مع تعيين معلمة outcount إلى الصفر.

  • array_of_indices
    إرجاع المؤشرات داخل المعلمة array_of_requests للعمليات المكتملة. فهارس الصفيف لا تستند إلى الصفر في C وقائمة على واحد في Fortran.

  • array_of_statuses
    إرجاع حالة العمليات المكتملة. تتوافق عناصر هذا الصفيف مع عناصر الصفيف array_of_indices .

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

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

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

إذا كانت الدالة ترجع خطأ غير MPI_ERR_IN_STATUS، فإنها لا تقوم بتحديث حقول الخطأ للحالات في المعلمة array_of_statuses .

الملاحظات

في بيئة متعددة مؤشرات الترابط، يجب على المستخدمين الحصول على تأمين Microsoft MPI العمومي باستخدام الدالة MSMPI_Queuelock_acquire قبل استدعاء MSMPI_Waitsome_interruptible. تتم مقاطعة هذه الدالة عندما يستدعي مؤشر ترابط آخر الدالة MSMPI_Queuelock_acquire من أجل الوصول إلى مكتبة MPI.

هذه الدالة هي ملحق للمعيار.

المتطلبات

منتج

حزمة HPC Pack 2012 MS-MPI القابلة لإعادة التوزيع، حزمة HPC Pack 2008 R2 MS-MPI القابلة لإعادة التوزيع، حزمة HPC Pack 2008 MS-MPI القابلة لإعادة التوزيع أو الأدوات المساعدة للعميل HPC Pack 2008

الرأس

Mpi.h

المكتبة

Msmpi.lib

Dll

Msmpi.dll

راجع أيضًا

MPI Point to Point Functions

MSMPI_Lock_queue

MSMPI_Queuelock_acquire

MSMPI_Queuelock_release

MPI_Waitsome