MPI_Mprobe الدالة

حظر التحقيقات لرسالة. يوفر آلية لتلقي الرسالة المحددة التي تمت مطابقتها بغض النظر عن عمليات الفحص/التلقي المتداخلة. يتم إلغاء وضع الرسالة المتطابقة في قائمة انتظار الاستلام، مما يمنح التطبيق فرصة لتحديد كيفية تلقي الرسالة استنادا إلى المعلومات التي تم إرجاعها بواسطة عملية الفحص المطابقة. ثم يتم تلقي الرسالة المتطابقة باستخدام الدالة MPI_Mrecv أو MPI_Imrecv .

بناء الجملة

int MPIAPI MPI_Mprobe(
  _In_  int         source,
  _In_  int         tag,
  _In_  MPI_Comm    comm,
  _Out_ MPI_Message *message,
  _Out_ MPI_Status  *status
);

المعلمات

• المصدر [in]
  ترتيب المصدر أو MPI_ANY_SOURCE.

• العلامة [in]
  علامة الرسالة أو MPI_ANY_TAG.

• comm [in]
  مقبض موصل MPI.

• رسالة [خارج]
  عند الإرجاع، يحتوي على مؤشر إلى الرسالة المتطابقة.

• الحالة [خارج]
  عند الإرجاع، يحتوي على مؤشر إلى بنية MPI_Status حيث يتم تخزين معلومات حول الرسالة.

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

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

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

Fortran

    MPI_MPROBE(SOURCE, TAG, COMM, MESSAGE, STATUS, IERROR)
          INTEGER SOURCE, TAG, COMM, MESSAGE, STATUS(MPI_STATUS_SIZE), IERROR

الملاحظات

تتصرف هذه الدالة مثل MPI_Improbe باستثناء أنها استدعاء حظر يرجع فقط بعد العثور على رسالة مطابقة.

المتطلبات

منتج	Microsoft MPI v6
الرأس	Mpi.h; Mpif.h
المكتبة	Msmpi.lib
Dll	Msmpi.dll

راجع أيضًا

MPI Point to Point Functions

MPI_Improbe

MPI_Recv

MPI_Imrecv