funzione MPI_Comm_create_keyval
Crea una nuova chiave dell'attributo.
Sintassi
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
);
Parametri
comm_copy_attr_fn [in, facoltativo]
Copiare la funzione di callback per keyval.comm_delete_attr_fn [in, facoltativo]
Eliminare la funzione di callback per keyval.comm_keyval [out]
Valore chiave per l'accesso futuro.extra_state [in, facoltativo]
Stato aggiuntivo per le funzioni di callback.
Valore restituito
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
Commenti
I valori chiave sono globali (disponibili per tutti i comunicatori e per tutti i comunicatori).
Sono disponibili le funzioni di copia ed eliminazione predefinite. Si tratta di MPI_COMM_NULL_COPY_FN - funzione di copia vuota MPI_COMM_NULL_DELETE_FN - funzione di eliminazione vuota MPI_COMM_DUP_FN - funzione dup semplice
Esistono piccole differenze tra C e Fortran che richiedono che il copy_fn essere scritto nello stesso linguaggio da cui viene chiamato MPI_Comm_create_keyval . Questo non dovrebbe essere un problema per la maggior parte degli utenti; solo i programmatori che usano Fortran e C nello stesso programma devono essere sicuri di seguire questa regola.
Requisiti
Prodotto |
Pacchetto ridistribuibile DI HPC Pack 2012 MS-MPI, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package o utilità client HPC Pack 2008 |
Intestazione |
Mpi.h; Mpif.h |
Libreria |
Msmpi.lib |
DLL |
Msmpi.dll |