مشاركة عبر


MPI_Waitany الدالة

يكمل واحدا من بين العديد من العمليات المعلقة.

بناء الجملة

int MPIAPI MPI_Waitany(
        int                              count,
        _Inout_count_(count) MPI_Request *array_of_requests,
  _Out_ int                              *index,
  _Out_ MPI_Status                       *status
);

المعلمات

  • count
    عدد الإدخالات في المعلمة array_of_requests .

  • array_of_requests
    صفيف من مقابض MPI_Request للعمليات المعلقة.

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

  • الحالة [خارج]
    مؤشر إلى كائن MPI_Status يصف العملية المكتملة.

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

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

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

Fortran

    MPI_WAITANY(COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS, IERROR)
        INTEGER COUNT, ARRAY_OF_REQUESTS, INDEX, STATUS(MPI_STATUS_SIZE), IERROR

الملاحظات

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

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

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

المتطلبات

منتج

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

MPI_Testany

MPI_Wait

MPI_Waitall

MPI_Waitsome

MPI_Status