MPI_Comm_copy_attr_function-Funktion

MPI_Comm_copy_attr_function ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

int MPI_Comm_copy_attr_function(
           MPI_Comm oldcomm,
           int      comm_keyval,
  _In_opt_ void     *extra_state,
  _In_     void     *attribute_val_in,
  _Out_    void     *attribute_val_out,
  _Out_    int      *flag
);

Parameter

• oldcomm
  Ursprünglicher Kommunikator.

• comm_keyval
  Schlüsselwert.

• extra_state [in, optional]
  Zusätzlicher Zustand.

• attribute_val_in [in]
  Quellattributewert.

• attribute_val_out [out]
  Wert des Zielattributes.

• Flag [out]
  Wenn der zurückgegebene Wert des Flags 0 oder FALSE ist, wird das Attribut im duplizierten Communicator gelöscht. Andernfalls (Flag = 1 oder TRUE) wird der neue Attributwert auf den in attribute_val_out zurückgegebenen Wert festgelegt.

Rückgabewert

Die Funktion gibt MPI_SUCCESS bei Erfolg und einen Fehlercode bei Einem Fehler zurück.

Fortran

    SUBROUTINE COMM_COPY_ATTR_FUNCTION(OLDCOMM, COMM_KEYVAL, EXTRA_STATE,
                ATTRIBUTE_VAL_IN, ATTRIBUTE_VAL_OUT, FLAG, IERROR)
        INTEGER OLDCOMM, COMM_KEYVAL, IERROR
        INTEGER(KIND=MPI_ADDRESS_KIND) EXTRA_STATE, ATTRIBUTE_VAL_IN,
            ATTRIBUTE_VAL_OUT
        LOGICAL FLAG

Hinweise

Die funktion comm_copy_attr_fn wird aufgerufen, wenn ein Kommunikator von MPI_Comm_dup dupliziert wird.

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

MPI_Comm_create_keyval