MPI_Rget-Funktion

Anforderungsbasierter RMA-Get-Vorgang.

Syntax

int MPIAPI MPI_Rget(
  _Out_ void         *origin_addr,
        int          origin_count,
        MPI_Datatype origin_datatype,
        int          target_rank,
        MPI_Aint     target_disp,
        int          target_count,
        MPI_Datatype datatype,
        MPI_Win      win,
  _Out_ MPI_Request  *request
);

Parameter

• origin_addr [out]
  Adresse des Puffers, in dem die Daten empfangen werden sollen.

• origin_count
  Anzahl der Einträge im Ursprungspuffer.

• origin_datatype
  Datentyp jedes Eintrags im Ursprungspuffer.

• 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.

• win
  Fensterobjekt, das für die Kommunikation verwendet wird.

• Anforderung [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_RGET(ORIGIN_ADDR, ORIGIN_COUNT, ORIGIN_DATATYPE, TARGET_RANK,
                TARGET_DISP, TARGET_COUNT, TARGET_DATATYPE, WIN, REQUEST, IERROR)
        <type> ORIGIN_ADDR(*)
        INTEGER(KIND=MPI_ADDRESS_KIND) TARGET_DISP
        INTEGER ORIGIN_COUNT, ORIGIN_DATATYPE, TARGET_RANK, TARGET_COUNT, TARGET_DATATYPE, WIN, REQUEST, IERROR

Hinweise

MPI_Rget ähnelt MPI_Get, mit der Ausnahme, dass es ein Kommunikationsanforderungsobjekt zuordnet und es dem Anforderungshandle (der Argumentanforderung) ordnet, das zum Warten oder Testen auf die Vervollständigung verwendet werden kann. Der Abschluss eines MPI_Rget-Vorgangs gibt an, dass die Daten im Ursprungspuffer verfügbar sind. Wenn origin_addr auf den Speicher verweist, der an ein Fenster angefügt ist, werden die Daten in der privaten Kopie dieses Fensters verfügbar.

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 Kommunikationsfunktionen