مشاركة عبر


الدالة MPI_Test

اختبار عملية معلقة لإكمالها.

بناء الجملة

int MPIAPI MPI_Test(
  _Inout_  MPI_Request *request,
  _Out_   int          *flag,
  _Out_   MPI_Status   *status
);

المعلمات

  • طلب [داخل، خارج]
    مؤشر إلى مؤشر MPI_Request لعملية معلقة.

  • علامة [خارج]
    عند الإرجاع، يحتوي على مؤشر إلى عدد صحيح يشير إلى ما إذا كان الطلب قد اكتمل أم لا. تشير القيمة غير الصفرية إلى اكتمال الطلب.

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

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

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

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

Fortran

    MPI_WAIT(REQUEST, FLAG, STATUS, IERROR)
        LOGICAL FLAG
        INTEGER REQUEST, STATUS(MPI_STATUS_SIZE), IERROR

الملاحظات

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

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

إذا كانت معلمة الطلب تشير إلى قيمة MPI_REQUEST_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 Point to Point Functions

MPI_Wait

MPI_Status

MPI_Testany

MPI_Testall

MPI_Testsome