MPI_Comm_free_keyval functie
Een bestaande kenmerksleutel wordt vrijgemaakt.
Syntaxis
int MPIAPI MPI_Comm_free_keyval(
_Inout_ int *comm_keyval
);
Parameters
-
comm_keyval
Sleutelwaarde.
Retourwaarde
Retourneert MPI_SUCCESS bij succes. Anders is de retourwaarde een foutcode.
In Fortran wordt de retourwaarde opgeslagen in de parameter IERROR .
Fortran
MPI_COMM_FREE_KEYVAL(COMM_KEYVAL, IERROR)
INTEGER COMM_KEYVAL, IERROR
Opmerkingen
Met deze functie wordt de waarde van keyval ingesteld op MPI_KEYVAL_INVALID. Houd er rekening mee dat het niet fout is om een kenmerksleutel die in gebruik is vrij te geven, omdat de werkelijke vrije sleutel pas wordt weergegeven nadat alle verwijzingen (in andere communicators van het proces) naar de sleutel zijn vrijgemaakt. Deze verwijzingen moeten expliciet worden vrijgemaakt door het programma, hetzij via aanroepen naar MPI_Comm_delete_attr dat gratis ene kenmerkexemplaren, of door aanroepen naar MPI_Comm_free die alle kenmerkexemplaren vrijmaken die zijn gekoppeld aan de vrijgemaakte communicator.
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 |