MPI_Rput-Funktion
Anforderungsbasierter RMA-Put-Vorgang.
Syntax
int MPIAPI MPI_Rput(
_In_ void *origin_addr,
int origin_count,
MPI_Datatype origin_datatype,
int target_rank,
MPI_Aint target_disp,
int target_count,
MPI_Datatype target_datatype,
MPI_Win win,
_Out_ MPI_Request *request
);
Parameter
origin_addr [in]
Ursprüngliche Adresse des Ursprungspuffers.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 Zielpuffer.target_count
Anzahl der Einträge im Zielpuffer.target_datatype
Datentyp jedes Eintrags im Zielpuffer.win
Für die Kommunikation verwendete Fensterobjekt.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_RPUT(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_Rput ähnelt MPI_Put, mit der Ausnahme, dass ein Kommunikationsanforderungsobjekt zugeordnet und dem Anforderungshandle (der Argumentanforderung) zugeordnet wird. Der Abschluss eines MPI_Rput Vorgangs (d. h. nach dem entsprechenden Test oder der Wartezeit) gibt an, dass der Absender jetzt frei ist, die Speicherorte im Ursprungspuffer zu aktualisieren. Es gibt nicht an, dass die Daten im Zielfenster verfügbar sind. Wenn eine Remoteabschlussung erforderlich ist, können MPI_Win_flush, MPI_Win_flush_all, MPI_Win_unlock oder MPI_Win_unlock_all verwendet werden.
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 |