إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
إجراء تلقي حظر لرسالة تطابقها MPI_Mprobe أو MPI_Improbe.
بناء الجملة
int MPIAPI MPI_Mrecv(
_Out_ void *buf,
_In_ int count,
_In_ MPI_Datatype datatype,
_Inout_ MPI_Message *message,
_Out_ MPI_Status *status
);
المعلمات
buf [out]
مؤشر إلى عنوان المخزن المؤقت للاستلام.العدد [in]
عدد عناصر نوع البيانات في buf.نوع البيانات [in]
نوع بيانات MPI للعناصر في صفيف المخزن المؤقت.رسالة [داخل، خارج]
يحتوي على مؤشر للرسالة.الحالة [خارج]
عند العودة، يحتوي على مؤشر إلى بنية MPI_Status حيث يتم تخزين معلومات حول الرسالة.
القيمة المُرجعة
إرجاع MPI_SUCCESS عند النجاح. وإلا، فإن القيمة المرجعة هي رمز خطأ.
في Fortran، يتم تخزين القيمة المرجعة في المعلمة IERROR .
Fortran
MPI_MRECV(BUF, COUNT, DATATYPE, MESSAGE, STATUS, IERROR)
<type> BUF(*)
INTEGER COUNT, DATATYPE, MESSAGE, STATUS(MPI_STATUS_SIZE), IERROR
الملاحظات
تتلقى هذه الدالة رسالة تطابقها عملية فحص مطابقة. يتكون المخزن المؤقت للاستلام من التخزين الذي يحتوي على عدد العناصر المتتالية من النوع المحدد بواسطة نوع البيانات، بدءا من العنوان buf. يجب أن يكون طول الرسالة المستلمة أقل من أو يساوي طول المخزن المؤقت للاستلام. يحدث خطأ تجاوز في حالة عدم احتواء جميع البيانات الواردة، دون اقتطاع، في المخزن المؤقت للاستلام.
إذا كانت الرسالة أقصر من المخزن المؤقت للاستلام، فسيتم تعديل المواقع المقابلة للرسالة (الأقصر) فقط.
عند العودة من هذه الدالة، يتم تعيين مقبض الرسالة إلى MPI_MESSAGE_NULL. تتم معالجة جميع الأخطاء التي تحدث أثناء تنفيذ هذه العملية وفقا لمعالج الأخطاء الذي تم تعيينه للمتصل المستخدم في استدعاء التحقيق المطابق الذي أنتج مقبض الرسالة
المتطلبات
منتج |
Microsoft MPI v6 |
الرأس |
Mpi.h؛ Mpif.h |
المكتبة |
Msmpi.lib |
Dll |
Msmpi.dll |