MPI_Comm_set_attr-Funktion

Speichert einen einem Schlüssel zugeordneten Attributwert.

Syntax

int MPIAPI MPI_Comm_set_attr(
       MPI_Comm comm,
       int      comm_keyval,
  _In_ void     *attribute_val
);

Parameter

• comm
  Communicator, an das attribut angefügt wird.

• comm_keyval
  Schlüsselwert, der von MPI_Comm_create_keyval zurückgegeben wird.

• attribute_val [in]
  Attributwert.

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_SET_ATTR(COMM, COMM_KEYVAL, ATTRIBUTE_VAL, IERROR)
        INTEGER COMM, COMM_KEYVAL, IERROR
        INTEGER(KIND=MPI_ADDRESS_KIND) ATTRIBUTE_VAL

Hinweise

Werte der permanenten Attribute MPI_TAG_UB, MPI_HOST, MPI_IO, MPI_WTIME_IS_GLOBAL, MPI_UNIVERSE_SIZE, MPI_LASTUSEDCODE und MPI_APPNUM können nicht geändert werden.

Der Datentyp des Attributwerts hängt davon ab, ob C, C++ oder Fortran verwendet wird. In C und C++ ist ein Attributwert ein void-Zeiger; In Fortran handelt es sich um eine ganze Zahl mit Adressgröße.

Wenn bereits ein Attribut vorhanden ist, wird die delete-Funktion (angegeben, als die entsprechende Keyval erstellt wurde) aufgerufen.

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-Cachefunktionen