Freigeben über


MPI_Rget_accumulate-Funktion

Der anforderungsbasierte RMA-Lese-/Änderungs-Schreibvorgang gibt die Daten vor dem Akkumulationsvorgang zurück.

Syntax

int MPIAPI MPI_Rget_accumulate(
  _In_  void         *origin_addr,
        int          origin_count,
        MPI_Datatype origin_datatype,
  _Out_ void         *result_addr,
        int          result_count,
        MPI_Datatype result_datatype,
        int          target_rank,
        MPI_Aint     target_disp,
        int          target_count,
        MPI_Datatype datatype,
        MPI_Op       op,
        MPI_Win      win,
  _Out_ MPI_Request  *request
);

Parameter

  • origin_addr [in]
    Anfängliche Adresse des Puffers

  • origin_count
    Anzahl der Einträge im Puffer

  • origin_datatype
    Datentyp der einzelnen Puffereinträge

  • result_addr [out]
    Erste Adresse des Ergebnispuffers

  • result_count
    Anzahl der Einträge im Ergebnispuffer

  • result_datatype
    Datentyp jedes Eintrags im Ergebnispuffer

  • target_rank
    Rang des Ziels

  • target_disp
    Verschiebung vom Anfang des Fensters zum Anfang des Zielpuffers

  • target_count
    Anzahl der Einträge im Zielpuffer

  • datatype
    Datentyp jedes Eintrags im Zielpuffer

  • Op
    vordefinierter Reduzierungsvorgang

  • win
    window-Objekt

  • Request [out]
    RMA-Anforderung

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_GET_RACCUMULATE(ORIGIN_ADDR, ORIGIN_COUNT, ORIGIN_DATATYPE, RESULT_ADDR, RESULT_COUNT, RESULT_DATATYPE,
                TARGET_RANK, TARGET_DISP, TARGET_COUNT, TARGET_DATATYPE, OP, WIN, REQUEST, IERROR)
        <type> ORIGIN_ADDR(*), RESULT_ADDR(*)
        INTEGER(KIND=MPI_ADDRESS_KIND) TARGET_DISP
        INTEGER ORIGIN_COUNT, ORIGIN_DATATYPE, RESULT_COUNT, RESULT_DATATYPE, TARGET_RANK, TARGET_COUNT,
        TARGET_DATATYPE, OP, WIN, REQUEST, IERROR

Hinweise

MPI_Rget_accumulate ähnelt MPI_Get_accumulate, mit der Ausnahme, dass es ein Kommunikationsanforderungsobjekt zuordnet und es dem Anforderungshandle (der Argumentanforderung) zuordnet, das zum Warten oder Testen auf den Abschluss verwendet werden kann. Der Abschluss eines MPI_Rget_accumulate Vorgangs gibt an, dass die Daten im Ergebnispuffer verfügbar sind und der Ursprungspuffer kostenlos aktualisiert werden kann. Es gibt nicht an, dass der Vorgang im Zielfenster abgeschlossen wurde.

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 One-Sided Communications Functions