funktionen MPI_Comm_create_keyval

Skapar en ny attributnyckel.

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
);

Parametrar

• comm_copy_attr_fn [in, valfritt]
  Kopiera återanropsfunktionen för keyval.

• comm_delete_attr_fn [in, valfritt]
  Ta bort återanropsfunktionen för keyval.

• comm_keyval [ut]
  Nyckelvärde för framtida åtkomst.

• extra_state [in, valfritt]
  Extra tillstånd för återanropsfunktioner.

Returvärde

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

Kommentarer

Nyckelvärden är globala (tillgängliga för alla kommunikatörer).

Standardfunktionerna för kopiering och borttagning är tillgängliga. Dessa är MPI_COMM_NULL_COPY_FN – tom kopieringsfunktion MPI_COMM_NULL_DELETE_FN – tom borttagningsfunktion MPI_COMM_DUP_FN – enkel dup-funktion

Det finns subtila skillnader mellan C och Fortran som kräver att copy_fn skrivas på samma språk som MPI_Comm_create_keyval anropas från. Detta bör inte vara ett problem för de flesta användare. endast programmerare som använder både Fortran och C i samma program måste vara säkra på att de följer den här regeln.

Krav

Produkt	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package eller HPC Pack 2008 Client Utilities
Huvud	Mpi.h; Mpif.h
Bibliotek	Msmpi.lib
DLL	Msmpi.dll

Se även

Cachelagringsfunktioner för MPI

MPI_Comm_copy_attr_function

MPI_Comm_delete_attr_function