MPI_Win_allocate functie
Hiermee maakt u een MPI-vensterobject dat geheugen toewijst.
Syntaxis
int MPIAPI MPI_Win_allocate(
MPI_Aint size,
int disp_unit,
MPI_Info info,
MPI_Comm comm,
_Out_ void *baseptr,
_Out_ MPI_Win *win
);
Parameters
Grootte
Grootte van het geheugenvenster in bytes.disp_unit
Lokale eenheidsgrootte voor verplaatsingen, in bytes.Info
Infoargument.Comm
Communicator.baseptr [uit]
Oorspronkelijk adres van het geheugenvenster.win [uit]
Vensterobject geretourneerd door de aanroep.
Retourwaarde
Retourneert MPI_SUCCESS bij succes. Anders is de retourwaarde een foutcode.
In Fortran wordt de retourwaarde opgeslagen in de parameter IERROR .
Fortran
MPI_WIN_ALLOCATE(SIZE, DISP_UNIT, INFO, COMM, BASEPTR, WIN, IERROR)
<type> BASEPTR(*)
INTEGER(KIND=MPI_ADDRESS_KIND) SIZE
INTEGER DISP_UNIT, INFO, COMM, WIN, IERROR
Opmerkingen
Dit is een collectieve aanroep die wordt uitgevoerd door alle processen in de groep van comm. Bij elk proces wordt geheugen van ten minste bytes toegewezen , wordt er een aanwijzer naartoe geretourneerd en wordt een vensterobject geretourneerd dat door alle processen in comm kan worden gebruikt om RMA-bewerkingen uit te voeren. Het geretourneerde geheugen bestaat uit grootte bytes lokaal voor elk proces, beginnend bij adres baseptr en is gekoppeld aan het venster alsof de gebruiker aangeroepen MPI_Win_create op bestaand geheugen. Het argument grootte kan bij elk proces verschillen en de grootte = 0 is geldig; Een bibliotheek kan echter meer geheugen toewijzen en beschikbaar maken om een snelle, wereldwijde symmetrische toewijzing te maken.
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 |