مشاركة عبر


MPI_Win_allocate_shared الدالة

إنشاء عنصر نافذة MPI الذي يخصص الذاكرة، ويمكن الوصول إلى الذاكرة المخصصة من جميع العمليات في مجموعة النافذة مع إرشادات التحميل/المتجر المباشرة.

بناء الجملة

int MPIAPI MPI_Win_allocate_shared(
        MPI_Aint size,
        int      disp_unit,
        MPI_Info info,
        MPI_Comm comm,
  _Out_ void     *baseptr,
  _Out_ MPI_Win  *win
);

المعلمات

  • size
    حجم نافذة الذاكرة بالبايت.

  • disp_unit
    حجم الوحدة المحلية للإزاحات بالبايت.

  • معلومات
    وسيطة المعلومات.

  • الاتصالات
    داخل التواصل.

  • baseptr [out]
    عنوان مقطع النافذة المخصصة المحلية.

  • win [out]
    كائن النافذة الذي تم إرجاعه بواسطة الاستدعاء.

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

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

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

Fortran

    MPI_WIN_ALLOCATE_SHARED(SIZE, DISP_UNIT, INFO, COMM, BASEPTR, WIN, IERROR)
        <type> BASEPTR(*)
        INTEGER(KIND=MPI_ADDRESS_KIND) SIZE
        INTEGER DISP_UNIT, INFO, COMM, WIN, IERROR

الملاحظات

هذا استدعاء جماعي تنفذه جميع العمليات في مجموعة comm. في كل عملية، يخصص ذاكرة بحجم بايت على الأقل تتم مشاركته بين جميع العمليات في comm، ويعيد مؤشرا إلى المقطع المخصص محليا في baseptr الذي يمكن استخدامه للوصول إلى التحميل/المتجر في عملية الاستدعاء. يمكن أن تكون الذاكرة المخصصة محليا هدفا للوصول إلى التحميل/التخزين بواسطة العمليات البعيدة؛ يمكن الاستعلام عن المؤشرات الأساسية للعمليات الأخرى باستخدام الدالة MPI_Win_shared_query. يقوم الاستدعاء أيضا بإرجاع كائن نافذة يمكن استخدامه من قبل جميع العمليات في comm لتنفيذ عمليات RMA. قد تختلف وسيطة الحجم في كل عملية وحجم = 0 صالح. تقع على عاتق المستخدم مسؤولية التأكد من أن الاتصال يمثل مجموعة من العمليات التي يمكنها إنشاء مقطع ذاكرة مشترك يمكن الوصول إليه من قبل جميع العمليات في المجموعة.

المتطلبات

منتج

حزمة 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 One-Sided Communications Functions