MPI_Comm_create_keyval functie
Hiermee maakt u een nieuwe kenmerksleutel.
Syntaxis
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
);
Parameters
comm_copy_attr_fn [in, optioneel]
Kopieer de callback-functie voor keyval.comm_delete_attr_fn [in, optioneel]
Verwijder de callback-functie voor keyval.comm_keyval [uit]
Sleutelwaarde voor toekomstige toegang.extra_state [in, optioneel]
Extra status voor callback-functies.
Retourwaarde
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
Opmerkingen
Sleutelwaarden zijn globaal (beschikbaar voor alle communicators).
Standaardfuncties voor kopiëren en verwijderen zijn beschikbaar. Dit zijn MPI_COMM_NULL_COPY_FN - lege functie voor kopiëren MPI_COMM_NULL_DELETE_FN - lege functie verwijderen MPI_COMM_DUP_FN - eenvoudige dup-functie
Er zijn subtiele verschillen tussen C en Fortran die vereisen dat de copy_fn worden geschreven in dezelfde taal van waaruit MPI_Comm_create_keyval wordt aangeroepen. Dit zou geen probleem moeten zijn voor de meeste gebruikers; alleen programers die zowel Fortran als C in hetzelfde programma gebruiken, moeten er zeker van zijn dat ze deze regel volgen.
Vereisten
Product |
HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package of HPC Pack 2008 Client Utilities |
Header |
Mpi.h; Mpif.h |
Bibliotheek |
Msmpi.lib |
DLL |
Msmpi.dll |