MPI_Rget functie
Op aanvraag gebaseerde RMA-bewerking ophalen.
Syntaxis
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
);
Parameters
origin_addr [uit]
Adres van de buffer waarin de gegevens moeten worden ontvangen.origin_count
Aantal vermeldingen in oorsprongbuffer.origin_datatype
Gegevenstype van elke vermelding in oorsprongbuffer.target_rank
Rang van doel.target_disp
Verplaatsing van het begin van het venster naar het begin van de doelbuffer.target_count
Aantal vermeldingen in doelbuffer.Datatype
Gegevenstype van elke vermelding in de doelbuffer.Winnen
Vensterobject dat wordt gebruikt voor communicatie.aanvraag [uit]
RMA-aanvraag.
Retourwaarde
Retourneert MPI_SUCCESS bij succes. Anders is de retourwaarde een foutcode.
In Fortran wordt de retourwaarde opgeslagen in de parameter IERROR .
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
Opmerkingen
MPI_Rget is vergelijkbaar met MPI_Get, behalve dat het een communicatieaanvraagobject toewijst en dit koppelt aan de aanvraaghandgreep (de argumentaanvraag) die kan worden gebruikt om te wachten of te testen op voltooiing. De voltooiing van een MPI_Rget-bewerking geeft aan dat de gegevens beschikbaar zijn in de oorspronkelijke buffer. Als origin_addr verwijst naar geheugen dat is gekoppeld aan een venster, worden de gegevens beschikbaar in de persoonlijke kopie van dit venster.
Vereisten
Product |
HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package of HPC Pack 2008 Client Utilities |
Header |
Mpi.h; Mpif.h |
Bibliotheek |
Msmpi.lib |
DLL |
Msmpi.dll |