MPI_Comm_create_keyval الدالة

إنشاء مفتاح سمة جديد.

بناء الجملة

int MPIAPI MPI_Comm_create_keyval(
  _In_opt_ MPI_Comm_copy_attr_function   *comm_copy_attr_fn,
  _In_opt_ MPI_Comm_delete_attr_function *comm_delete_attr_fn,
  _Out_    int                           *comm_keyval,
  _In_opt_ void                          *extra_state
);

المعلمات

• comm_copy_attr_fn [في، اختياري]
  نسخ دالة رد الاتصال ل keyval.

• comm_delete_attr_fn [في، اختياري]
  حذف دالة رد الاتصال ل keyval.

• comm_keyval [خارج]
  القيمة الرئيسية للوصول المستقبلي.

• extra_state [في، اختياري]
  حالة إضافية لوظائف رد الاتصال.

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

MPI_SUCCESS

Fortran

    MPI_COMM_CREATE_KEYVAL(COMM_COPY_ATTR_FN, COMM_DELETE_ATTR_FN, COMM_KEYVAL,
            EXTRA_STATE, IERROR)
        EXTERNAL COMM_COPY_ATTR_FN, COMM_DELETE_ATTR_FN
        INTEGER COMM_KEYVAL, IERROR
        INTEGER(KIND=MPI_ADDRESS_KIND) EXTRA_STATE

الملاحظات

القيم الرئيسية عمومية (متاحة لأي وجميع الموصلين).

تتوفر دالات النسخ والحذف الافتراضية. هذه MPI_COMM_NULL_COPY_FN- MPI_COMM_NULL_DELETE_FN دالة النسخ الفارغة - دالة حذف فارغة MPI_COMM_DUP_FN - دالة dup بسيطة

هناك اختلافات دقيقة بين C و Fortran تتطلب كتابة copy_fn بنفس اللغة التي يتم استدعاء MPI_Comm_create_keyval منها. يجب ألا تكون هذه مشكلة لمعظم المستخدمين؛ يحتاج المبرمجون الذين يستخدمون كلا من Fortran وC في نفس البرنامج إلى التأكد من اتباعهم لهذه القاعدة.

المتطلبات

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

MPI_Comm_copy_attr_function

MPI_Comm_delete_attr_function