الدالة MPI_Irecv

بدء عملية تلقي وإرجاع مؤشر إلى عملية الاتصال المطلوبة.

بناء الجملة

int MPIAPI MPI_Irecv(
  _In_opt_ void         *buf,
           int          count,
           MPI_Datatype datatype,
           int          source,
           int          tag,
           MPI_Comm     comm,
  _Out_    MPI_Request  *request
);

المعلمات

• buf [in, optional]
  مؤشر إلى المخزن المؤقت الذي يحتوي على البيانات التي سيتم إرسالها.

• count
  عدد العناصر في صفيف المخزن المؤقت. إذا كان جزء البيانات من الرسالة فارغا، فقم بتعيين معلمة العد إلى 0.

• Datatype
  نوع بيانات العناصر في المخزن المؤقت.

• مصدر
  رتبة عملية الإرسال داخل communicator المحدد. حدد ثابت MPI_ANY_SOURCE لتحديد أن أي مصدر مقبول.

• العلامه
  علامة الرسالة التي يمكن استخدامها لتمييز أنواع مختلفة من الرسائل. حدد ثابت MPI_ANY_TAG للإشارة إلى أن أي علامة مقبولة.

• الاتصالات
  المقبض إلى communicator.

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

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

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

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

Fortran

    MPI_IRECV(BUF, COUNT, DATATYPE, SOURCE, TAG, COMM, REQUEST, IERROR)
        <type> BUF(*)
        INTEGER COUNT, DATATYPE, SOURCE, TAG, COMM, REQUEST, IERROR

الملاحظات

هذه الدالة محلية، وترجع على الفور، ولا تنتظر أي عملية أخرى. يمكن أن ترجع هذه الدالة قبل تلقي الرسالة في المخزن المؤقت.

المتطلبات

منتج	حزمة 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_Send

MPI_Recv

MPI_Wait

MPI_Test

MPI_Comm

MPI_Datatype