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 |