MPI_Comm_free_keyval-Funktion
Gibt einen verfügbaren Attributschlüssel frei.
Syntax
int MPIAPI MPI_Comm_free_keyval(
_Inout_ int *comm_keyval
);
Parameter
-
comm_keyval
Schlüsselwert.
Rückgabewert
Gibt MPI_SUCCESS nach Erfolg zurück. Andernfalls ist der Rückgabewert ein Fehlercode.
In Fortran wird der Rückgabewert im IERROR-Parameter gespeichert.
Fortran
MPI_COMM_FREE_KEYVAL(COMM_KEYVAL, IERROR)
INTEGER COMM_KEYVAL, IERROR
Hinweise
Diese Funktion legt den Wert von keyval auf MPI_KEYVAL_INVALID fest. Beachten Sie, dass es nicht falsch ist, einen verwendeten Attributschlüssel frei zu geben, da der tatsächliche Freiwert erst dann übertragen wird, wenn alle Verweise (in anderen Kommunikatoren auf dem Prozess) auf den Schlüssel freigegeben wurden. Diese Verweise müssen vom Programm explizit freigegeben werden, entweder über Aufrufe an MPI_Comm_delete_attr dieses freie Attributs instance, oder durch Aufrufe von MPI_Comm_free, die alle Attributinstanzen freigibt, die dem freigegebenen Communicator zugeordnet sind.
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 |