MPI_Comm_get_attr-Funktion

Ruft den Attributwert nach Schlüssel ab.

Syntax

int MPIAPI MPI_Comm_get_attr(
        MPI_Comm comm,
        int      comm_keyval,
  _Out_ void     *attribute_val,
  _Out_ int      *flag
);

Parameter

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

• comm_keyval
  Schlüsselwert.

• attribute_val [out]
  Attributwert, es sei denn , flag = false.

• flag [out]
  True, wenn ein Attributwert extrahiert wurde; false, wenn dem Schlüssel kein Attribut zugeordnet ist.

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

Hinweise

Attribute müssen aus derselben Sprache extrahiert werden, in die sie mit MPI_Comm_set_attr eingefügt wurden. Obwohl das attribute_val-Argument als void-Zeiger deklariert wird, ist es tatsächlich die Adresse eines void-Zeigers. Weitere Informationen finden Sie in der Begründung in der Norm.

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