MPI_Comm_create_keyval-Funktion
Erstellt einen neuen Attributschlüssel.
Syntax
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
);
Parameter
comm_copy_attr_fn [in, optional]
Kopieren Sie die Rückruffunktion für keyval.comm_delete_attr_fn [in, optional]
Löschen Sie die Rückruffunktion für keyval.comm_keyval [out]
Schlüsselwert für den zukünftigen Zugriff.extra_state [in, optional]
Zusätzlicher Status für Rückruffunktionen.
Rückgabewert
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
Hinweise
Die Schlüsselwerte sind global (für alle Kommunikatoren verfügbar).
Standardmäßige Kopier- und Löschfunktionen sind verfügbar. Dies sind MPI_COMM_NULL_COPY_FN - leere Kopierfunktion MPI_COMM_NULL_DELETE_FN - Leerlöschfunktion MPI_COMM_DUP_FN - einfache Dupfunktion
Es gibt subtile Unterschiede zwischen C und Fortran, die erfordern, dass die copy_fn in derselben Sprache geschrieben werden, von der MPI_Comm_create_keyval aufgerufen wird. Dies sollte für die meisten Benutzer kein Problem darstellen. nur Programmierer, die sowohl Fortran als auch C im selben Programm verwenden, müssen sicher sein, dass sie diese Regel befolgen.
Anforderungen
Produkt |
HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package oder HPC Pack 2008 Client Utilities |
Header |
Mpi.h; Mpif.h |
Bibliothek |
Msmpi.lib |
DLL |
Msmpi.dll |