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

Weitere Informationen

MPI-Zwischenspeicherungsfunktionen

MPI_Comm_copy_attr_function

MPI_Comm_delete_attr_function