Olvasás angol nyelven

Megosztás a következőn keresztül:


MPI_Comm_create_keyval függvény

Létrehoz egy új attribútumkulcsot.

Szintaxis

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
);

Paraméterek

  • comm_copy_attr_fn [in, nem kötelező]
    A keyval visszahívási függvényének másolása.

  • comm_delete_attr_fn [in, nem kötelező]
    A keyval visszahívási függvényének törlése.

  • comm_keyval [ki]
    Kulcsérték a jövőbeli hozzáféréshez.

  • extra_state [in, nem kötelező]
    Extra állapot a visszahívási függvényekhez.

Visszatérési érték

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

Megjegyzések

A kulcsértékek globálisak (bármely és minden kommunikátor számára elérhetők).

Az alapértelmezett másolási és törlési függvények elérhetők. Ezek MPI_COMM_NULL_COPY_FN – üres másolási függvény MPI_COMM_NULL_DELETE_FN – üres törlési függvény MPI_COMM_DUP_FN – egyszerű dup függvény

A C és a Fortran között vannak apró különbségek, amelyek megkövetelik, hogy a copy_fn ugyanabban a nyelven legyen megírva, amelyről MPI_Comm_create_keyval meghívják. Ez nem lehet probléma a legtöbb felhasználó számára; Csak a Fortran és a C programot ugyanabban a programban használó programozóknak kell meggyőződniük arról, hogy betartják ezt a szabályt.

Követelmények

Termék

HPC Pack 2012 MS-MPI terjeszthető csomag, HPC Pack 2008 R2 MS-MPI terjeszthető csomag, HPC Pack 2008 MS-MPI terjeszthető csomag vagy HPC Pack 2008 Client Utilities

Fejléc

Mpi.h; Mpif.h

Kódtár

Msmpi.lib

DLL

Msmpi.dll

Lásd még

MPI-gyorsítótárazási függvények

MPI_Comm_copy_attr_function

MPI_Comm_delete_attr_function